A message on a negotiation

POST

/dsp/negotiations/{pid}/{action}

curl --request POST \
  --url https://example.com/dsp/negotiations/example/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

The other messages of a negotiation, for both roles: request (ContractRequestMessage), offers (ContractOfferMessage), agreement (ContractAgreementMessage), events (ContractNegotiationEventMessage, ACCEPTED or FINALIZED) and termination (ContractNegotiationTerminationMessage). The same message again gets the same answer.

Authorizations

• dcp

Parameters

Path Parameters

pid

required

string

Our process id (providerPid or consumerPid).

action

required

string

request, offers, agreement, events or termination.

Request Body^required

The message that action names.

Media typeapplication/json

object

Example ^generated

{}

Responses

200

The ContractNegotiation.

Media typeapplication/json

object

Example ^generated

{}

400

Not a valid message, or not allowed in the state of the process.

Media typeapplication/json

A DSP error (dspace:…Error): code and reason, as JSON-LD.

object

@context

required

object

@type

required

E.g. ContractNegotiationError.

string

code

required

string

reason

required

Array<string>

Example ^generated

{
  "@context": {},
  "@type": "example",
  "code": "example",
  "reason": [
    "example"
  ]
}

401

No valid token.

Media typeapplication/json

A DSP error (dspace:…Error): code and reason, as JSON-LD.

object

@context

required

object

@type

required

E.g. ContractNegotiationError.

string

code

required

string

reason

required

Array<string>

Example ^generated

{
  "@context": {},
  "@type": "example",
  "code": "example",
  "reason": [
    "example"
  ]
}

404

Unknown process.

Media typeapplication/json

A DSP error (dspace:…Error): code and reason, as JSON-LD.

object

@context

required

object

@type

required

E.g. ContractNegotiationError.

string

code

required

string

reason

required

Array<string>

Example ^generated

{
  "@context": {},
  "@type": "example",
  "code": "example",
  "reason": [
    "example"
  ]
}

503

The message could not be recorded as evidence, so it was not processed.

Media typeapplication/json

A DSP error (dspace:…Error): code and reason, as JSON-LD.

object

@context

required

object

@type

required

E.g. ContractNegotiationError.

string

code

required

string

reason

required

Array<string>

Example ^generated

{
  "@context": {},
  "@type": "example",
  "code": "example",
  "reason": [
    "example"
  ]
}