> For the complete documentation index, see [llms.txt](https://knowledgebase.fabricdata.com/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.fabricdata.com/studio/integrations-and-apis/origin-studio-production-api/credits.md).

# Credits

Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits.

## Get a single credit list

> Retrieve a single credit list by its ID. Returns the list's name, ranking, default flag, and relationship links to the parent record and owning tenant.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Credits","description":"Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"CreditsListFindOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListFindOneResponse","description":"Response returned when retrieving a single credit list by ID. Contains the list's attributes (name, ranking, isDefault) combined with base timestamps (created, updated), plus relationship links to the owning tenant and parent record.","type":"object","additionalProperties":false,"required":["data","links"],"properties":{"data":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["creditsLists"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/CreditsListAttributes","required":["name"]}]},"relationships":{"$ref":"#/components/schemas/CreditsListRelationships"}}},"links":{"$ref":"#/components/schemas/LinksRelated"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"CreditsListAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListAttributes","description":"Attributes of a credits list. A credits list is a named, ordered collection of credit entries for a specific record. `name` is the display name. `ranking` controls ordering when multiple lists exist. `isDefault` identifies the primary credits list for the record.","type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","description":"Display name for the credit list. For example, `\"Main Credits\"` or `\"International Credits\"`."},"ranking":{"type":"number","description":"Numeric ordering value used to sort credit lists when a record has more than one. Lower values appear first. If omitted, the list is appended after existing lists."},"isDefault":{"type":"boolean","description":"When `true`, this credit list is treated as the primary credits for the record. Only one credit list per record should be designated as the default."}}},"CreditsListRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListRelationships","description":"JSON:API relationship links for a credits list resource. Contains links to the owning tenant and the record this credits list is associated with.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"},"record":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","enum":["records"]},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false}},"required":["tenant","record"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"Standard JSON:API error response returned when a request fails. Contains an `errors` array with one or more error objects (status, title, and optional detail).","type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"A single JSON:API error object. `status` is the HTTP status code as a string. `title` is a short, human-readable summary. `detail` provides optional context. `meta` may include structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error (e.g. `/data/attributes/title`).","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"Error stack trace. Only present in non-production environments."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/records/{recordId}/creditsLists/{creditsListId}":{"get":{"summary":"Get a single credit list","operationId":"creditsListFindOne","description":"Retrieve a single credit list by its ID. Returns the list's name, ranking, default flag, and relationship links to the parent record and owning tenant.","tags":["Credits"],"parameters":[{"name":"recordId","description":"The ID of the record that owns the credit list.","in":"path","required":true,"schema":{"type":"string"}},{"name":"creditsListId","description":"The ID of the credit list to retrieve.","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsListFindOneResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Update a single credit list

> Partially update a credit list by its ID. Only the attributes included in the request body are changed. You can update the list's \`name\`, \`ranking\` order, and whether it is the \`isDefault\` list for the record.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Credits","description":"Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"CreditsListUpdateOneRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListUpdateOneRequest","description":"Request body for partially updating a credits list. Only the attributes included in the request are modified. Supports updating the list's `name`, `ranking`, and `isDefault` flag.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"allOf":[{"type":"object","required":["type"],"additionalProperties":false,"properties":{"type":{"type":"string","enum":["creditsLists"]}}},{"type":"object","required":["attributes"],"additionalProperties":false,"properties":{"attributes":{"$ref":"#/components/schemas/CreditsListAttributes"}}}]}},"required":["data"],"additionalProperties":false},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Optional audit metadata for a write request. `audit.source` is the issuing surface/channel (e.g. studio-web, mcp, api, system); `audit.reason` is a free-text justification. Both are optional and length-capped.","type":"object","additionalProperties":false,"properties":{"audit":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":64},"reason":{"type":"string","maxLength":256}}}}},"CreditsListAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListAttributes","description":"Attributes of a credits list. A credits list is a named, ordered collection of credit entries for a specific record. `name` is the display name. `ranking` controls ordering when multiple lists exist. `isDefault` identifies the primary credits list for the record.","type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","description":"Display name for the credit list. For example, `\"Main Credits\"` or `\"International Credits\"`."},"ranking":{"type":"number","description":"Numeric ordering value used to sort credit lists when a record has more than one. Lower values appear first. If omitted, the list is appended after existing lists."},"isDefault":{"type":"boolean","description":"When `true`, this credit list is treated as the primary credits for the record. Only one credit list per record should be designated as the default."}}},"CreditsListCreateOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListCreateOneResponse","description":"Response returned after successfully creating a credit list. Contains the new resource's ID, type, and relationship links to the owning tenant and parent record. Use the returned ID to fetch the full credit list with its attributes.","type":"object","additionalProperties":false,"required":["data","links"],"properties":{"data":{"type":"object","required":["id","type","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["creditsLists"]},"relationships":{"additionalProperties":false,"required":["tenant","record"],"properties":{"tenant":{"type":"object","required":["data","links"],"properties":{"data":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"additionalProperties":false},"record":{"type":"object","required":["data","links"],"properties":{"data":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["records"]}},"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"additionalProperties":false}}}}},"links":{"$ref":"#/components/schemas/LinksRelated"}}},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"Standard JSON:API error response returned when a request fails. Contains an `errors` array with one or more error objects (status, title, and optional detail).","type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"A single JSON:API error object. `status` is the HTTP status code as a string. `title` is a short, human-readable summary. `detail` provides optional context. `meta` may include structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error (e.g. `/data/attributes/title`).","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"Error stack trace. Only present in non-production environments."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/records/{recordId}/creditsLists/{creditsListId}":{"patch":{"summary":"Update a single credit list","operationId":"creditsListUpdateOne","description":"Partially update a credit list by its ID. Only the attributes included in the request body are changed. You can update the list's `name`, `ranking` order, and whether it is the `isDefault` list for the record.","tags":["Credits"],"parameters":[{"name":"recordId","description":"The ID of the record that owns the credit list.","in":"path","required":true,"schema":{"type":"string"}},{"name":"creditsListId","description":"The ID of the credit list to update.","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsListUpdateOneRequest"}}}},"responses":{"200":{"description":"Updated OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsListCreateOneResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get many credit lists for a record

> List all credit lists associated with a record. Use the \`filter.isDefault\` query parameter to narrow results to only the default credit list. Results include each list's name, ranking, and relationship links.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Credits","description":"Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"CreditsListFindManyResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListFindManyResponse","description":"Response returned when listing all credit lists for a record. The `data` array contains zero or more credit list resources, each with its name, ranking, and isDefault flag. The `meta.filters` object echoes back the applied `isDefault` filter value. Use `links` for pagination navigation.","type":"object","additionalProperties":false,"required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["creditsLists"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/CreditsListAttributes"}]},"relationships":{"$ref":"#/components/schemas/CreditsListRelationships"},"links":{"$ref":"#/components/schemas/LinksRelated"}}}},"meta":{"type":"object","properties":{"filters":{"type":"object","required":["isDefault"],"properties":{"isDefault":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"CreditsListAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListAttributes","description":"Attributes of a credits list. A credits list is a named, ordered collection of credit entries for a specific record. `name` is the display name. `ranking` controls ordering when multiple lists exist. `isDefault` identifies the primary credits list for the record.","type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","description":"Display name for the credit list. For example, `\"Main Credits\"` or `\"International Credits\"`."},"ranking":{"type":"number","description":"Numeric ordering value used to sort credit lists when a record has more than one. Lower values appear first. If omitted, the list is appended after existing lists."},"isDefault":{"type":"boolean","description":"When `true`, this credit list is treated as the primary credits for the record. Only one credit list per record should be designated as the default."}}},"CreditsListRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListRelationships","description":"JSON:API relationship links for a credits list resource. Contains links to the owning tenant and the record this credits list is associated with.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"},"record":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","enum":["records"]},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false}},"required":["tenant","record"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"Standard JSON:API error response returned when a request fails. Contains an `errors` array with one or more error objects (status, title, and optional detail).","type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"A single JSON:API error object. `status` is the HTTP status code as a string. `title` is a short, human-readable summary. `detail` provides optional context. `meta` may include structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error (e.g. `/data/attributes/title`).","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"Error stack trace. Only present in non-production environments."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/records/{recordId}/creditsLists":{"get":{"summary":"Get many credit lists for a record","operationId":"creditsListFindMany","description":"List all credit lists associated with a record. Use the `filter.isDefault` query parameter to narrow results to only the default credit list. Results include each list's name, ranking, and relationship links.","tags":["Credits"],"parameters":[{"name":"recordId","description":"The ID of the record whose credit lists to retrieve.","in":"path","required":true,"schema":{"type":"string"}},{"name":"filter.isDefault","in":"query","required":false,"schema":{"type":"boolean"},"description":"When `true`, returns only the default credit list for the record. When `false`, returns only non-default lists. Omit to return all lists."}],"responses":{"200":{"description":"Successfully retrieved credits lists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsListFindManyResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Create a single credit list

> Create a new credit list for a record. Provide a display \`name\` for the list. Optionally set a \`ranking\` to control display order when a record has multiple credit lists, and \`isDefault\` to mark this as the primary list for the record.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Credits","description":"Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"CreditsListCreateOneRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListCreateOneRequest","description":"Request body for creating a new credit list for a record. Requires a `name` for the list. Optionally provide a client-generated `id` (16 lowercase hex characters) to control the list's identifier; re-sending the same `id` for the same record is rejected as a duplicate rather than creating a second list. Omit it to have the server generate one. Optionally set `ranking` to control sort order among multiple lists, and `isDefault` to designate this as the primary credit list for the record. The record association is determined by the `recordId` path parameter.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"allOf":[{"type":"object","required":["type"],"additionalProperties":false,"properties":{"type":{"type":"string","enum":["creditsLists"]},"id":{"type":"string","pattern":"^[a-f0-9]{16}$","description":"Optional client-generated identifier. Must be 16 lowercase hexadecimal characters. When provided, re-sending the same `id` for the same record is rejected as a duplicate. If omitted, the server generates one."}}},{"type":"object","required":["attributes"],"additionalProperties":false,"properties":{"attributes":{"allOf":[{"$ref":"#/components/schemas/CreditsListAttributes","required":["name"]}]}}}]}},"required":["data"],"additionalProperties":false},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Optional audit metadata for a write request. `audit.source` is the issuing surface/channel (e.g. studio-web, mcp, api, system); `audit.reason` is a free-text justification. Both are optional and length-capped.","type":"object","additionalProperties":false,"properties":{"audit":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":64},"reason":{"type":"string","maxLength":256}}}}},"CreditsListAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListAttributes","description":"Attributes of a credits list. A credits list is a named, ordered collection of credit entries for a specific record. `name` is the display name. `ranking` controls ordering when multiple lists exist. `isDefault` identifies the primary credits list for the record.","type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"type":"string","description":"Display name for the credit list. For example, `\"Main Credits\"` or `\"International Credits\"`."},"ranking":{"type":"number","description":"Numeric ordering value used to sort credit lists when a record has more than one. Lower values appear first. If omitted, the list is appended after existing lists."},"isDefault":{"type":"boolean","description":"When `true`, this credit list is treated as the primary credits for the record. Only one credit list per record should be designated as the default."}}},"CreditsListCreateOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListCreateOneResponse","description":"Response returned after successfully creating a credit list. Contains the new resource's ID, type, and relationship links to the owning tenant and parent record. Use the returned ID to fetch the full credit list with its attributes.","type":"object","additionalProperties":false,"required":["data","links"],"properties":{"data":{"type":"object","required":["id","type","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["creditsLists"]},"relationships":{"additionalProperties":false,"required":["tenant","record"],"properties":{"tenant":{"type":"object","required":["data","links"],"properties":{"data":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"additionalProperties":false},"record":{"type":"object","required":["data","links"],"properties":{"data":{"type":"object","required":["id","type"],"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["records"]}},"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"additionalProperties":false}}}}},"links":{"$ref":"#/components/schemas/LinksRelated"}}},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"Standard JSON:API error response returned when a request fails. Contains an `errors` array with one or more error objects (status, title, and optional detail).","type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"A single JSON:API error object. `status` is the HTTP status code as a string. `title` is a short, human-readable summary. `detail` provides optional context. `meta` may include structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error (e.g. `/data/attributes/title`).","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"Error stack trace. Only present in non-production environments."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/records/{recordId}/creditsLists":{"post":{"summary":"Create a single credit list","operationId":"creditsListCreateOne","description":"Create a new credit list for a record. Provide a display `name` for the list. Optionally set a `ranking` to control display order when a record has multiple credit lists, and `isDefault` to mark this as the primary list for the record.","tags":["Credits"],"parameters":[{"name":"recordId","description":"The ID of the record to create the credit list for.","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsListCreateOneRequest"}}}},"responses":{"201":{"description":"Created OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsListCreateOneResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Execute atomic operations on a credit list

> Apply one or more credit operations (\`add\`, \`update\`, \`remove\`) to a credit list in a single transactional call. Use \`add\` to create a new credit entry linking a contributor with a job role. Use \`update\` to modify an existing credit's attributes. Use \`remove\` to delete a credit. All operations in a single request succeed or fail together.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Credits","description":"Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"CreditsListAtomicOperationsRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListAtomicOperationsRequest","description":"JSON:API Atomic Operations request for managing credits within a credits list. Supports `add` (create a new credit for a contributor), `update` (modify an existing credit's attributes), and `remove` (delete a credit) operations in a single transactional call.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"atomic:operations":{"type":"array","description":"An ordered list of credit operations to apply atomically. Each operation specifies an `op` code (`add`, `update`, or `remove`) and the relevant data or reference. All operations succeed or fail together — no partial updates are applied.","items":{"type":"object","oneOf":[{"description":"Add a new credit entry to the list. Provide the contributor relationship, job role, and optional ranking and character names.","properties":{"op":{"const":"add"},"data":{"$ref":"#/components/schemas/dataObject"}},"required":["op","data"],"additionalProperties":false},{"description":"Update an existing credit entry. Identify the credit to update via `ref` (by ID and type) and supply the new attribute values in `data`.","properties":{"op":{"const":"update"},"ref":{"$ref":"#/components/schemas/updateRefObject"},"data":{"$ref":"#/components/schemas/dataObject"}},"required":["op","data"],"additionalProperties":false},{"description":"Remove an existing credit entry from the list. Identify the credit to delete via `ref` using its ID.","properties":{"op":{"const":"remove"},"ref":{"$ref":"#/components/schemas/removeRefObject"}},"required":["op","ref"],"additionalProperties":false}]}}},"required":["atomic:operations"],"additionalProperties":false,"definitions":{"dataObject":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]},"attributes":{"type":"object","properties":{"job":{"type":"string","enum":["Actor","Director","Executive Producer","Producer","Creator","Writer","Editor"]},"ranking":{"type":"number","minimum":0},"characters":{"type":"array","items":{"type":"string"}}},"required":["job"],"additionalProperties":false},"relationships":{"type":"object","properties":{"contributor":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","enum":["contributors"]},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}},"required":["contributor"],"additionalProperties":false}},"required":["type","attributes","relationships"],"additionalProperties":false},"updateRefObject":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]},"relationship":{"type":"string","enum":["contributors"]}},"required":["id","type","relationship"],"additionalProperties":false},"removeRefObject":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]}},"required":["id","type"],"additionalProperties":false}}},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Optional audit metadata for a write request. `audit.source` is the issuing surface/channel (e.g. studio-web, mcp, api, system); `audit.reason` is a free-text justification. Both are optional and length-capped.","type":"object","additionalProperties":false,"properties":{"audit":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":64},"reason":{"type":"string","maxLength":256}}}}},"dataObject":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]},"attributes":{"type":"object","properties":{"job":{"type":"string","enum":["Actor","Director","Executive Producer","Producer","Creator","Writer","Editor"]},"ranking":{"type":"number","minimum":0},"characters":{"type":"array","items":{"type":"string"}}},"required":["job"],"additionalProperties":false},"relationships":{"type":"object","properties":{"contributor":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","enum":["contributors"]},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}},"required":["contributor"],"additionalProperties":false}},"required":["type","attributes","relationships"],"additionalProperties":false},"updateRefObject":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]},"relationship":{"type":"string","enum":["contributors"]}},"required":["id","type","relationship"],"additionalProperties":false},"removeRefObject":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]}},"required":["id","type"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"Standard JSON:API error response returned when a request fails. Contains an `errors` array with one or more error objects (status, title, and optional detail).","type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"A single JSON:API error object. `status` is the HTTP status code as a string. `title` is a short, human-readable summary. `detail` provides optional context. `meta` may include structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error (e.g. `/data/attributes/title`).","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"Error stack trace. Only present in non-production environments."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/records/{recordId}/creditsLists/{creditsListId}/operations":{"post":{"summary":"Execute atomic operations on a credit list","operationId":"creditsListAtomicOperations","description":"Apply one or more credit operations (`add`, `update`, `remove`) to a credit list in a single transactional call. Use `add` to create a new credit entry linking a contributor with a job role. Use `update` to modify an existing credit's attributes. Use `remove` to delete a credit. All operations in a single request succeed or fail together.","tags":["Credits"],"parameters":[{"name":"recordId","description":"The ID of the record that owns the credit list.","in":"path","required":true,"schema":{"type":"string"}},{"name":"creditsListId","description":"The ID of the credit list to apply operations to.","in":"path","schema":{"type":"string"},"required":true}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsListAtomicOperationsRequest"}}},"required":true},"responses":{"204":{"description":"Accepted"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Payload Too Large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get many credits for a credit list

> List the credits in a credit list, filtered by job role. Returns contributor details, billing order (\`ranking\`), and character names where applicable. Supports cursor-based pagination for large casts.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Credits","description":"Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"CreditsFindManyResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsFindManyResponse","description":"Response returned when listing credits for a credit list. The `data` array contains credit entries for the requested job role, each with ranking, character names (for acting credits), and relationship links to the contributor, record, credit list, and tenant. The `meta.filters` object echoes back the applied job filter. Supports cursor-based pagination via `meta.filters.cursor`.","type":"object","additionalProperties":false,"required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/CreditsAttributes","required":["job"]}]},"relationships":{"$ref":"#/components/schemas/CreditsRelationships"},"links":{"$ref":"#/components/schemas/LinksRelated"}}}},"meta":{"type":"object","required":["filters"],"properties":{"filters":{"type":"object","description":"Pagination and filter state for the current result set.","required":["job"],"properties":{"job":{"$ref":"#/components/schemas/CreditsAttributeJob"},"cursor":{"type":"string","description":"Opaque cursor value to pass as `page.cursor` in the next request to retrieve the following page of results. Absent when there are no more pages."},"numberOfItems":{"type":"number","description":"Total number of credits matching the filter, if available."},"perPage":{"type":"number","description":"Maximum number of results returned per page."}},"additionalProperties":false}},"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"CreditsAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsAttributes","description":"Attributes of a single credit entry representing a contributor's involvement in a record. `job` is the contributor's role (e.g., Actor, Director). `ranking` is the billing order within the credits list. `characters` lists character names for acting credits.","type":"object","required":["job"],"additionalProperties":false,"properties":{"job":{"$ref":"#/components/schemas/CreditsAttributeJob"},"ranking":{"type":"number","minimum":0,"description":"Billing order of this credit within its job category. Lower values indicate higher prominence (e.g., top-billed Actor). Must be zero or greater."},"characters":{"type":"array","description":"List of character names this contributor portrays in the title. Only relevant for acting credits (e.g., Actor). May be empty for crew roles.","items":{"type":"string","minLength":1}}}},"CreditsAttributeJob":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsAttributeJob","description":"The role or function a contributor performed in the production of a work. Defines the supported credit job types in Origin Studio.","type":"string","enum":["Actor","Director","Executive Producer","Producer","Creator","Writer","Editor"]},"CreditsRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsRelationships","description":"JSON:API relationship links for a credit resource. Contains links to the owning tenant, the record the credit belongs to, the credits list it appears in, and the contributor being credited.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"},"record":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","enum":["records"]},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"contributor":{"$ref":"#/components/schemas/ContributorRelationship"},"creditsList":{"$ref":"#/components/schemas/CreditsListRelationship"}},"required":["tenant","record","contributor","creditsList"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"ContributorRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorRelationship","description":"A relationship to a contributor","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["contributors"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"CreditsListRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListRelationship","description":"A JSON:API relationship reference to a credit list resource. Contains the credit list's `id` and `type` (always `\"creditsLists\"`), plus a `links.related` URL to fetch the full credit list.","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["creditsLists"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"Standard JSON:API error response returned when a request fails. Contains an `errors` array with one or more error objects (status, title, and optional detail).","type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"A single JSON:API error object. `status` is the HTTP status code as a string. `title` is a short, human-readable summary. `detail` provides optional context. `meta` may include structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error (e.g. `/data/attributes/title`).","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"Error stack trace. Only present in non-production environments."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/records/{recordId}/creditsLists/{creditsListId}/credits":{"get":{"summary":"Get many credits for a credit list","operationId":"creditsFindMany","description":"List the credits in a credit list, filtered by job role. Returns contributor details, billing order (`ranking`), and character names where applicable. Supports cursor-based pagination for large casts.","tags":["Credits"],"parameters":[{"name":"recordId","description":"The ID of the record that owns the credit list.","in":"path","required":true,"schema":{"type":"string"}},{"name":"creditsListId","description":"The ID of the credit list to retrieve credits from.","in":"path","required":true,"schema":{"type":"string"}},{"name":"filter.job","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"string"},"description":"Filter credits by job role. Must be one of the supported roles: `Actor`, `Director`, `Executive Producer`, `Producer`, `Creator`, `Writer`, `Editor`. Example: `filter.job=Actor`"},{"name":"page.cursor","in":"query","description":"Opaque cursor value returned by a previous response for fetching the next page of results.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsFindManyResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get many credits for a contributor

> List all credits associated with a specific contributor, filtered by job role. Useful for finding all titles where a contributor has a particular role, such as all records where they are credited as an Actor.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Credits","description":"Manage credit lists and individual credits in the context of records. A credit list is a named, ordered collection of cast and crew entries for a record. Each credit entry links a contributor to a record via a job role (e.g., Actor, Director). All tenants may reference shared, system-provided contributors when assigning credits."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"CreditsFindManyResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsFindManyResponse","description":"Response returned when listing credits for a credit list. The `data` array contains credit entries for the requested job role, each with ranking, character names (for acting credits), and relationship links to the contributor, record, credit list, and tenant. The `meta.filters` object echoes back the applied job filter. Supports cursor-based pagination via `meta.filters.cursor`.","type":"object","additionalProperties":false,"required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/CreditsAttributes","required":["job"]}]},"relationships":{"$ref":"#/components/schemas/CreditsRelationships"},"links":{"$ref":"#/components/schemas/LinksRelated"}}}},"meta":{"type":"object","required":["filters"],"properties":{"filters":{"type":"object","description":"Pagination and filter state for the current result set.","required":["job"],"properties":{"job":{"$ref":"#/components/schemas/CreditsAttributeJob"},"cursor":{"type":"string","description":"Opaque cursor value to pass as `page.cursor` in the next request to retrieve the following page of results. Absent when there are no more pages."},"numberOfItems":{"type":"number","description":"Total number of credits matching the filter, if available."},"perPage":{"type":"number","description":"Maximum number of results returned per page."}},"additionalProperties":false}},"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"CreditsAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsAttributes","description":"Attributes of a single credit entry representing a contributor's involvement in a record. `job` is the contributor's role (e.g., Actor, Director). `ranking` is the billing order within the credits list. `characters` lists character names for acting credits.","type":"object","required":["job"],"additionalProperties":false,"properties":{"job":{"$ref":"#/components/schemas/CreditsAttributeJob"},"ranking":{"type":"number","minimum":0,"description":"Billing order of this credit within its job category. Lower values indicate higher prominence (e.g., top-billed Actor). Must be zero or greater."},"characters":{"type":"array","description":"List of character names this contributor portrays in the title. Only relevant for acting credits (e.g., Actor). May be empty for crew roles.","items":{"type":"string","minLength":1}}}},"CreditsAttributeJob":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsAttributeJob","description":"The role or function a contributor performed in the production of a work. Defines the supported credit job types in Origin Studio.","type":"string","enum":["Actor","Director","Executive Producer","Producer","Creator","Writer","Editor"]},"CreditsRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsRelationships","description":"JSON:API relationship links for a credit resource. Contains links to the owning tenant, the record the credit belongs to, the credits list it appears in, and the contributor being credited.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"},"record":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","enum":["records"]},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":false},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"contributor":{"$ref":"#/components/schemas/ContributorRelationship"},"creditsList":{"$ref":"#/components/schemas/CreditsListRelationship"}},"required":["tenant","record","contributor","creditsList"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"ContributorRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorRelationship","description":"A relationship to a contributor","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["contributors"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"CreditsListRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListRelationship","description":"A JSON:API relationship reference to a credit list resource. Contains the credit list's `id` and `type` (always `\"creditsLists\"`), plus a `links.related` URL to fetch the full credit list.","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["creditsLists"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"Standard JSON:API error response returned when a request fails. Contains an `errors` array with one or more error objects (status, title, and optional detail).","type":"object","required":["errors"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"A single JSON:API error object. `status` is the HTTP status code as a string. `title` is a short, human-readable summary. `detail` provides optional context. `meta` may include structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error (e.g. `/data/attributes/title`).","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"Error stack trace. Only present in non-production environments."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"paths":{"/contributors/{contributorId}/credits":{"get":{"summary":"Get many credits for a contributor","operationId":"creditsFindManyByContributor","description":"List all credits associated with a specific contributor, filtered by job role. Useful for finding all titles where a contributor has a particular role, such as all records where they are credited as an Actor.","tags":["Credits"],"parameters":[{"name":"contributorId","description":"The ID of the contributor whose credits to retrieve.","in":"path","required":true,"schema":{"type":"string"}},{"name":"filter.job","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"string"},"description":"Filter credits by job role. Must be one of the supported roles: `Actor`, `Director`, `Executive Producer`, `Producer`, `Creator`, `Writer`, `Editor`. Example: `filter.job=Actor`"}],"responses":{"200":{"description":"Successfully retrieved credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsFindManyResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```