> ## Documentation Index > Fetch the complete documentation index at: https://docs.floral.so/llms.txt > Use this file to discover all available pages before exploring further. # Update an event participant > Partially update a participant's details and registration answers. Changing a restricted answer requires the event organiser or a workspace admin. ## OpenAPI ````yaml /openapi/public-v1.json patch /api/v1/workspaces/{workspaceSlug}/events/{eventId}/participants/{participantId} openapi: 3.1.0 info: description: >- Stable external API for relationship lookup, meeting intelligence, and event participation. title: Floral Public API version: 1.0.0 servers: - description: Production url: https://app.floral.so security: [] tags: - description: Search across active companies and people. name: Search - description: Create, list, inspect, update, archive, and restore companies. name: Companies - description: Create, list, inspect, update, archive, and restore people. name: People - description: Read active public custom-field definitions. name: Custom fields - description: Search normalized Danish company-register facts. name: Company registry - description: Generate, list, and inspect meeting briefings. name: Briefings - description: List, inspect, annotate, and approve meeting summaries. name: Summaries - description: >- List and inspect events, and finalise their attendance. Requires the Events add-on. name: Events - description: >- Register, list, inspect, and update event participants, mark attendance, and correct finalised attendance. Requires the Events add-on. name: Event participants paths: /api/v1/workspaces/{workspaceSlug}/events/{eventId}/participants/{participantId}: patch: tags: - Event participants summary: Update an event participant description: >- Partially update a participant's details and registration answers. Changing a restricted answer requires the event organiser or a workspace admin. operationId: updateEventParticipantV1 parameters: - description: Slug of the workspace pinned to the credential. example: acme-nordic in: path name: workspaceSlug required: true schema: maxLength: 100 minLength: 1 pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ type: string - description: Stable numeric event ID. example: 42 in: path name: eventId required: true schema: minimum: 1 type: integer - description: Stable participant UUID. example: 0f8b6c1e-3a52-4d6e-9b7a-2c4e5f6a7b8c in: path name: participantId required: true schema: format: uuid type: string - description: >- Optional caller-generated correlation ID. Floral returns the effective value in X-Request-ID. example: 550e8400-e29b-41d4-a716-446655440000 in: header name: X-Request-ID required: false schema: maxLength: 128 minLength: 1 type: string - description: >- Strong ETag from the latest detail or mutation response. A stale value returns 412 VERSION_CONFLICT. example: >- "v1.eyJpZCI6IjBmOGI2YzFlLTNhNTItNGQ2ZS05YjdhLTJjNGU1ZjZhN2I4YyIsInJlc291cmNlIjoicGFydGljaXBhbnQiLCJ2ZXJzaW9uIjoiMyJ9" in: header name: If-Match required: true schema: pattern: ^"(?:[^"\\]|\\.)*"$ type: string requestBody: content: application/json: example: phone: +45 20 99 88 77 schema: $ref: '#/components/schemas/EventParticipantPatchRequest' description: >- Omitted fields remain unchanged. responses contains only the answers to change; null clears an optional answer. Maximum 65536 bytes. required: true responses: '200': content: application/json: example: participant: attendanceState: UNKNOWN company: id: 42 name: Acme Nordic companyName: Acme Nordic createdAt: '2026-09-02T10:20:00.000Z' email: ada@acme-nordic.example eventId: 42 id: 0f8b6c1e-3a52-4d6e-9b7a-2c4e5f6a7b8c matchStatus: MATCHED name: Ada Jensen person: id: 84 name: Ada Jensen phone: +45 20 99 88 77 registrationState: REGISTERED representedCompany: establishmentNumber: null id: 42 name: Acme Nordic responses: session_track: answeredAt: '2026-09-02T10:20:00.000Z' value: Workplace strategy source: HOSTED updatedAt: '2026-09-12T08:05:00.000Z' version: >- v1.eyJpZCI6IjBmOGI2YzFlLTNhNTItNGQ2ZS05YjdhLTJjNGU1ZjZhN2I4YyIsInJlc291cmNlIjoicGFydGljaXBhbnQiLCJ2ZXJzaW9uIjoiMyJ9 waitlistPosition: null schema: $ref: '#/components/schemas/EventParticipantDetailResponse' description: Participant updated headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string ETag: description: Opaque version for a subsequent If-Match. example: >- "v1.eyJpZCI6IjBmOGI2YzFlLTNhNTItNGQ2ZS05YjdhLTJjNGU1ZjZhN2I4YyIsInJlc291cmNlIjoicGFydGljaXBhbnQiLCJ2ZXJzaW9uIjoiMyJ9" schema: pattern: ^"(?:[^"\\]|\\.)*"$ type: string '400': content: application/json: example: error: code: INVALID_INPUT message: The request contains invalid values. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - INVALID_INPUT type: string required: - code type: object type: object description: 'Stable errors: INVALID_INPUT' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '401': content: application/json: example: error: code: UNAUTHENTICATED message: A valid bearer credential is required. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - UNAUTHENTICATED type: string required: - code type: object type: object description: 'Stable errors: UNAUTHENTICATED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string WWW-Authenticate: description: Bearer authentication challenge. example: Bearer realm="floral-api" schema: type: string '403': content: application/json: example: error: code: FORBIDDEN message: The credential does not grant this operation. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - FORBIDDEN type: string required: - code type: object type: object description: 'Stable errors: FORBIDDEN' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '404': content: application/json: example: error: code: NOT_FOUND message: The resource was not found. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - NOT_FOUND - FEATURE_DISABLED type: string required: - code type: object type: object description: 'Stable errors: NOT_FOUND, FEATURE_DISABLED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '409': content: application/json: example: error: code: CONFLICT message: >- The requested change conflicts with the current resource state. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - CONFLICT type: string required: - code type: object type: object description: 'Stable errors: CONFLICT' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '412': content: application/json: example: error: code: VERSION_CONFLICT message: The resource changed since it was read. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - VERSION_CONFLICT type: string required: - code type: object type: object description: 'Stable errors: VERSION_CONFLICT' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '428': content: application/json: example: error: code: PRECONDITION_REQUIRED message: If-Match is required for this operation. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - PRECONDITION_REQUIRED type: string required: - code type: object type: object description: 'Stable errors: PRECONDITION_REQUIRED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '429': content: application/json: example: error: code: RATE_LIMITED message: Too many requests. Retry shortly. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - RATE_LIMITED type: string required: - code type: object type: object description: 'Stable errors: RATE_LIMITED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string Retry-After: description: Seconds until the current limit resets. schema: minimum: 1 type: integer '500': content: application/json: example: error: code: INTERNAL_ERROR message: An unexpected error occurred. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - INTERNAL_ERROR type: string required: - code type: object type: object description: 'Stable errors: INTERNAL_ERROR' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string security: - bearerAuth: [] x-codeSamples: - label: cURL lang: Shell source: |- curl --request PATCH \ --url 'https://app.floral.so/api/v1/workspaces/acme-nordic/events/42/participants/0f8b6c1e-3a52-4d6e-9b7a-2c4e5f6a7b8c' \ --header 'Authorization: Bearer $FLORAL_TOKEN' \ --header 'If-Match: "v1.eyJpZCI6IjBmOGI2YzFlLTNhNTItNGQ2ZS05YjdhLTJjNGU1ZjZhN2I4YyIsInJlc291cmNlIjoicGFydGljaXBhbnQiLCJ2ZXJzaW9uIjoiMyJ9"' \ --header 'Content-Type: application/json' \ --data '{ "phone": "+45 20 99 88 77" }' components: schemas: EventParticipantPatchRequest: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: companyName: anyOf: - type: string maxLength: 255 - type: 'null' email: anyOf: - type: string maxLength: 320 format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: 'null' name: type: string minLength: 1 maxLength: 255 phone: anyOf: - type: string maxLength: 64 - type: 'null' responses: type: object propertyNames: type: string minLength: 1 maxLength: 64 additionalProperties: anyOf: - anyOf: - type: string maxLength: 5000 - type: number - type: boolean - maxItems: 50 type: array items: type: string maxLength: 1000 - type: 'null' maxProperties: 50 additionalProperties: false minProperties: 1 EventParticipantDetailResponse: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: participant: type: object properties: attendanceState: type: string enum: - UNKNOWN - ATTENDED - NO_SHOW company: anyOf: - type: object properties: id: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 name: type: string required: - id - name additionalProperties: false - type: 'null' companyName: type: - string - 'null' createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ email: type: - string - 'null' eventId: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ matchStatus: type: string enum: - UNMATCHED - MATCHED - AMBIGUOUS - REVIEWED name: type: - string - 'null' person: anyOf: - type: object properties: id: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 name: type: string required: - id - name additionalProperties: false - type: 'null' phone: type: - string - 'null' registrationState: type: string enum: - REGISTERED - WAITLISTED - CANCELLED representedCompany: anyOf: - type: object properties: establishmentNumber: type: - string - 'null' id: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' name: type: string required: - establishmentNumber - id - name additionalProperties: false - type: 'null' responses: type: object propertyNames: type: string minLength: 1 maxLength: 64 additionalProperties: type: object properties: answeredAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ value: anyOf: - type: string - type: number - type: boolean - type: array items: type: string required: - answeredAt - value additionalProperties: false source: type: string enum: - HOSTED - EMBED - MANUAL - WALK_IN - AGENT - API updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ version: type: string minLength: 1 maxLength: 512 pattern: ^v1\.[A-Za-z0-9_-]+$ waitlistPosition: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' required: - attendanceState - company - companyName - createdAt - email - eventId - id - matchStatus - name - person - phone - registrationState - representedCompany - responses - source - updatedAt - version - waitlistPosition additionalProperties: false required: - participant additionalProperties: false ApiErrorResponse: additionalProperties: false properties: error: additionalProperties: false properties: code: enum: - CONFLICT - FEATURE_DISABLED - FORBIDDEN - IDEMPOTENCY_CONFLICT - INTERNAL_ERROR - INVALID_INPUT - INVALID_STATE - NOT_FOUND - PRECONDITION_REQUIRED - RATE_LIMITED - UNAUTHENTICATED - VERSION_CONFLICT type: string message: minLength: 1 type: string requestId: maxLength: 128 minLength: 1 type: string required: - code - message - requestId type: object required: - error type: object securitySchemes: bearerAuth: bearerFormat: Floral PAT description: Authenticate with a workspace-pinned Floral personal access token. scheme: bearer type: http ````