POST/event-stream-tickets

Create a one-use 60-second WebSocket ticket

Bearer Tokenevents:read

Request

curl · Sandboxbash

curl --request POST \
  'https://sandbox-api.padel-lab.crewio.co/v1/club/event-stream-tickets' \
  --header 'Authorization: Bearer $PADEL_LAB_TOKEN' \
  --header 'Idempotency-Key: 018f-unique-request-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "after": "018f5f21-5b62-7a08-8d4c-bc61d6b19a01"
}'

Parameter

Idempotency-Keyheaderstringrequired

Unique key retained for 24 hours on authenticated mutation endpoints. The installation-exchange binding is retained permanently with its consumed authorization code. Reuse with different request content returns IDEMPOTENCY_CONFLICT.

Request Body

EventStreamTicketInputoptional

Examplejson

{
  "after": "018f5f21-5b62-7a08-8d4c-bc61d6b19a01"
}

JSON Schema anzeigen

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "after": {
      "type": [
        "string",
        "null"
      ],
      "format": "uuid"
    }
  }
}

Responses

201Ticket createdEventStreamTicketResponse

400Malformed JSON or a syntactically valid request that violates a path, query, header or JSON-body constraint.ErrorResponse

401Missing, invalid or expired tokenErrorResponse

403Installation lacks the required scope or is inactiveErrorResponse

409Version, idempotency, mapping, state or resource-limit conflictErrorResponse

429Rate limit exceededErrorResponse

500An unexpected runtime error occurred; retry only when the operation is safe or idempotent.ErrorResponse

503A required authorization, tenant-safety or rate-limit dependency is unavailableErrorResponse

Response Schemas

EventStreamTicketResponseStatus 201

{
  "type": "object",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "ticket",
        "expires_at",
        "websocket_url"
      ],
      "properties": {
        "ticket": {
          "type": "string"
        },
        "expires_at": {
          "type": "string",
          "format": "date-time",
          "description": "UTC RFC 3339 timestamp"
        },
        "websocket_url": {
          "type": "string"
        }
      }
    }
  }
}

ErrorResponseStatus 400, 401, 403, 409, 429, 500, 503

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "code",
        "message",
        "request_id"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "Stable machine-readable code. Clients must tolerate unknown codes within the same HTTP class.",
          "examples": [
            "invalid_request",
            "invalid_cursor",
            "IDEMPOTENCY_KEY_REQUIRED",
            "unsafe_webhook_url",
            "authentication_required",
            "invalid_token",
            "insufficient_scope",
            "installation_inactive",
            "not_found",
            "VERSION_CONFLICT",
            "UNMAPPED_COURT",
            "IDEMPOTENCY_CONFLICT",
            "IDEMPOTENCY_IN_PROGRESS",
            "endpoint_limit_reached",
            "rate_limited",
            "internal_error",
            "idempotency_replay_failed",
            "authorization_unavailable",
            "rate_limit_unavailable"
          ]
        },
        "message": {
          "type": "string"
        },
        "request_id": {
          "type": "string"
        },
        "details": {}
      }
    }
  }
}