TrieOH
UniventsAPISignatures

Fulfill a signature request

Completes a pending signature request by uploading the signatory's signature image. Authenticated by the signature-request token passed as the `token` query parameter (NOT a JWT). The token binds this call to a single request/edition.

POST/signature-requests/fulfill

Completes a pending signature request by uploading the signatory's signature image. Authenticated by the signature-request token passed as the token query parameter (NOT a JWT). The token binds this call to a single request/edition.

Query Parameters

token*string

HMAC-signed signature-request token.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/signature-requests/fulfill?token=string" \  -H "Content-Type: application/json" \  -d '{    "image_url": "https://cdn.trieoh.com/signatures/jane.png"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "edition_id": "aeda7fca-56fe-426a-8c37-1876faaaf005",
  "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
  "signatory_name": "string",
  "signatory_title": "string",
  "signatory_email": "user@example.com",
  "signatory_user_id": "232888e2-acc5-4f86-809b-e06bf28b18e9",
  "image_url": "http://example.com",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "deleted_at": "2019-08-24T14:15:22Z"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 400,
  "title": "Validation Failed"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 401,
  "title": "Unauthenticated"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 404,
  "title": "Not Found"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 409,
  "title": "Person Has Ticket"
}
{
  "detail": "string",
  "instance": "../dictionary",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "type": "http://example.com",
  "status": 500,
  "title": "Internal Server Error"
}

Cancel a signature request POST

Cancels a pending signature request, optionally with a reason. The actor must be an owner or admin of the event.

Deny a signature request POST

Denies a pending signature request. Authenticated by the signature-request token passed as the `token` query parameter (NOT a JWT).