> 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.2817"},"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","jsonapi"],"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"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"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.2817"},"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":"Audit metadata for a write request. `audit.source` names the surface that sent it, such as `studio-web`, `studio-mcp`, `api` or `system`; `audit.reason` is a free-text justification.","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."}}},"CreditsListUpdateOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsListUpdateOneResponse","description":"Response returned after successfully updating a credit list. Contains the resource's ID, type, and relationship links to the owning tenant and parent record.","$ref":"#/components/schemas/CreditsListCreateOneResponse"},"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","jsonapi"],"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"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"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/CreditsListUpdateOneResponse"}}}},"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.2817"},"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","jsonapi"],"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"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"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.2817"},"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":"Audit metadata for a write request. `audit.source` names the surface that sent it, such as `studio-web`, `studio-mcp`, `api` or `system`; `audit.reason` is a free-text justification.","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","jsonapi"],"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"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"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; it never creates one, so an \`update\` for a credit that no longer exists fails the request with 404. An \`update\` names the credit in \`data.id\`; a \`ref\` sent with it must name the same credit, otherwise 409. 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.2817"},"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, named by `data.id`, with the values in `data`. A `ref` is optional; when sent, it must name the same credit, otherwise the request fails with 409. The credit is never created: if it no longer exists, the request fails with 404.","properties":{"op":{"const":"update"},"ref":{"$ref":"#/components/schemas/updateRefObject"},"data":{"$ref":"#/components/schemas/updateDataObject"}},"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},"updateDataObject":{"description":"The credit to update, as a resource object: `data.id` names it.","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","id","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":"Audit metadata for a write request. `audit.source` names the surface that sent it, such as `studio-web`, `studio-mcp`, `api` or `system`; `audit.reason` is a free-text justification.","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},"updateDataObject":{"description":"The credit to update, as a resource object: `data.id` names it.","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","id","attributes","relationships"],"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":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false}}},"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; it never creates one, so an `update` for a credit that no longer exists fails the request with 404. An `update` names the credit in `data.id`; a `ref` sent with it must name the same credit, otherwise 409. 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"}}}},"404":{"description":"Not Found. The record or credit list does not exist, or an `update` targets a credit that no longer exists.","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.2817"},"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.cursor`.","type":"object","additionalProperties":false,"required":["data","meta","links","jsonapi"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Credit"}},"meta":{"$ref":"#/components/schemas/CreditsPageMeta"},"links":{"$ref":"#/components/schemas/LinksRelated"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Credit":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICredit","description":"A contributor's credit on a record: the job, ranking and, for acting credits, the characters played.","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"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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},"CreditsPageMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsPageMeta","type":"object","required":["filters"],"properties":{"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."},"filters":{"type":"object","description":"Pagination and filter state for the current result set.","required":["job"],"properties":{"job":{"$ref":"#/components/schemas/CreditsAttributeJob"},"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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"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 a contributor's credits for one job role, such as every record that credits them as an Actor. A credit you cannot read comes back restricted, with only its id and \`meta.restricted\`. To get the next page, pass \`meta.cursor\` back as \`page.cursor\`; stop when a response has no cursor. The last page can be empty.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2817"},"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":{"ContributorCreditsFindManyResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorCreditsFindManyResponse","description":"One page of a contributor's credits for one job. A credit you cannot read comes back restricted, with only its id.","type":"object","additionalProperties":false,"required":["data","meta","links","jsonapi"],"properties":{"data":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/Credit"},{"$ref":"#/components/schemas/RestrictedCredit"}]}},"meta":{"$ref":"#/components/schemas/CreditsPageMeta"},"links":{"$ref":"#/components/schemas/LinksRelated"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Credit":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICredit","description":"A contributor's credit on a record: the job, ranking and, for acting credits, the characters played.","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"}}},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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},"RestrictedCredit":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRestrictedCredit","description":"A credit you cannot read. Only its id is returned.","type":"object","required":["id","type","meta"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["credits"]},"meta":{"type":"object","required":["restricted"],"additionalProperties":false,"properties":{"restricted":{"type":"boolean","enum":[true],"description":"Always `true`: you cannot read this credit."}}}}},"CreditsPageMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ICreditsPageMeta","type":"object","required":["filters"],"properties":{"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."},"filters":{"type":"object","description":"Pagination and filter state for the current result set.","required":["job"],"properties":{"job":{"$ref":"#/components/schemas/CreditsAttributeJob"},"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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"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 a contributor's credits for one job role, such as every record that credits them as an Actor. A credit you cannot read comes back restricted, with only its id and `meta.restricted`. To get the next page, pass `meta.cursor` back as `page.cursor`; stop when a response has no cursor. The last page can be empty.","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`"},{"name":"page.cursor","in":"query","description":"The `meta.cursor` of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorCreditsFindManyResponse"}}}},"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"}}}}}}}}}
```
