# Roles

A person can be assigned a role inside an organization, team or match. This is the job, position or responsibility they hold. The routes allow roles to be returned that are linked to matches or not.

## Get a list of non-match roles

> Return a list of roles for the organization (not linked to matches)

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"dateFromEnd":{"name":"dateFromEnd","description":"Where dateFrom <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateFromStart":{"name":"dateFromStart","description":"Where dateFrom >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToEnd":{"name":"dateToEnd","description":"Where dateTo <= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"dateToStart":{"name":"dateToStart","description":"Where dateTo >= this value","schema":{"type":"string","format":"date"},"required":false,"in":"query"},"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"nameFamilyLatinStartsWith":{"name":"nameFamilyLatinStartsWith","description":"Family latin name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFamilyLocalStartsWith":{"name":"nameFamilyLocalStartsWith","description":"Family local name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatin":{"name":"nameFullLatin","description":"The full name of the person in latin characters","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatinContains":{"name":"nameFullLatinContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLatin=David Johnson nameFullLatinContains=Dav will match nameFullLatinContains=John will match nameFullLatinContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameFullLocal":{"name":"nameFullLocal","description":"The full name of the person","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLocalContains":{"name":"nameFullLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLocal=David Johnson nameFullLocalContains=Dav will match nameFullLocalContains=John will match nameFullLocalContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"role":{"name":"role","description":"Role. Can specify multiple values delimited by comma.\n>- `ADMINISTRATOR_TOURNAMENT` Tournament Administrator\n>- `APPEAL_JURY` Appeal Jury\n>- `APPEAL_JURY_PRESIDENT` Appeal Jury President\n>- `ASSISTANT_REFEREE_1` Assistant Referee 1\n>- `ASSISTANT_REFEREE_2` Assistant Referee 2\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `CLUB_IT_OFFICER` Club IT Officer\n>- `CLUB_OFFICIAL` Club Official\n>- `CLUB_OFFICIAL_ASSISTANT` Substitute for contact person of club\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_GK` Goalkeeper Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strength and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DELEGATE` Delegate\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE` Judge\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `LIAISON_OFFICER` Liaison Officer\n>- `MANAGER` Manager\n>- `MATCH_LIAISON` Match Liaison\n>- `MATCH_MANAGER` Match Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MATCH_SUPERVISOR` Match Supervisor\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_OFFICER` Medical Officer\n>- `MEDICAL_OFFICER_CF` Medical Officer (Continental Federation)\n>- `MEDICAL_OFFICER_FIH` Medical Officer (FIH)\n>- `MEDICAL_STAFF` Medical Staff\n>- `NATIONAL_TOURNAMENT_OFFICIAL` National Tournament Official\n>- `OFFICE_STAFF` Office Staff\n>- `OFFICIAL_A` Official A\n>- `OFFICIAL_B` Official B\n>- `OFFICIAL_C` Official C\n>- `OFFICIAL_D` Official D\n>- `OFFICIAL_E` Official E\n>- `OTHER` Other\n>- `PHYSICAL_TRAINER` Physical Trainer\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PLAYER_CONTRACT_MANAGER` Player Contract Manager\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `PSYCHOLOGIST` Psychologist\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_LIAISON` Referee Liaison\n>- `REFEREE_OBSERVER` Referee Observer\n>- `REFEREE_OBSERVER_LIAISON` Referee Observer Liaison\n>- `REFEREE_RESERVE` Reserve Referee\n>- `REPRESENTATIVE_ASSOCIATION` Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_CONTINENTAL` Continental Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_GOVERNING_BODY` Governing Body Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_INTERCONTINENTAL` Intercontinental Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_INTERNATIONAL` International Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_NATIONAL` National Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_REGIONAL` Regional Association Representative\n>- `REPRESENTATIVE_CONTINENTAL_FEDERATION` Continental Federation Representative\n>- `REPRESENTATIVE_FEDERATION` Federation Representative\n>- `REPRESENTATIVE_GOVERNING_BODY` Governing Body Representative\n>- `REPRESENTATIVE_INTERCONTINENTAL_FEDERATION` Intercontinental Federation Representative\n>- `REPRESENTATIVE_INTERNATIONAL_FEDERATION` International Federation Representative\n>- `REPRESENTATIVE_NATIONAL_FEDERATION` National Federation Representative\n>- `REPRESENTATIVE_REGIONAL_FEDERATION` Regional Federation Representative\n>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SCOUT_1` Scout 1\n>- `SCOUT_2` Scout 2\n>- `SCOUT_3` Scout 3\n>- `SCOUT_SUPERVISOR` Scout Supervisor\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `SPORT_DIRECTOR` Sporting Director\n>- `STAND_IN_MANAGER` Stand-In Manager\n>- `STATISTICIAN` Statistician\n>- `TEAM_COORDINATOR` Team Coordinator\n>- `TEAM_LEADER` Team Leader\n>- `TEAM_MANAGER` Team Manager\n>- `TEAM_MEDIA_OFFICER` Team Media Officer\n>- `TECHNICAL_DELEGATE` Technical Delegate\n>- `TECHNICAL_DELEGATE_ASSISTANT` Assistant Technical Delegate\n>- `TECHNICAL_OFFICER` Technical Officer\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assistant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_ASSISTANT_MANAGER` Assistant Umpire Manager\n>- `UMPIRE_MANAGER` Umpire Manager\n>- `UMPIRE_NATIONAL` National Umpire\n>- `UMPIRE_NEUTRAL` Neutral Umpire\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_ANALYST` Video Analyst\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n>- `YOUTH_COORDINATOR` Youth Coordinator\n","schema":{"type":"string","enum":["ADMINISTRATOR_TOURNAMENT","APPEAL_JURY","APPEAL_JURY_PRESIDENT","ASSISTANT_REFEREE_1","ASSISTANT_REFEREE_2","COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_GK","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DELEGATE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","MATCH_SUPERVISOR","SCOUT_SUPERVISOR","COMMISSIONER","STATISTICIAN","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","SCOUT_1","SCOUT_2","SCOUT_3","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","UMPIRE_MANAGER","UMPIRE_ASSISTANT_MANAGER","UMPIRE_NATIONAL","UMPIRE_NEUTRAL","UMPIRE_RESERVE","UMPIRE_VIDEO","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","REFEREE_OBSERVER","CREW_CHIEF","JUDGE","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_DELEGATE","TECHNICAL_DELEGATE_ASSISTANT","TECHNICAL_OFFICIAL","MATCH_MANAGER","MEDICAL_OFFICER","MEDICAL_OFFICER_CF","MEDICAL_OFFICER_FIH","MEDIA_OFFICER","NATIONAL_TOURNAMENT_OFFICIAL","PHYSICAL_TRAINER","PSYCHOLOGIST","REPRESENTATIVE_ASSOCIATION","REPRESENTATIVE_ASSOCIATION_CONTINENTAL","REPRESENTATIVE_ASSOCIATION_GOVERNING_BODY","REPRESENTATIVE_ASSOCIATION_INTERCONTINENTAL","REPRESENTATIVE_ASSOCIATION_INTERNATIONAL","REPRESENTATIVE_ASSOCIATION_NATIONAL","REPRESENTATIVE_ASSOCIATION_REGIONAL","REPRESENTATIVE_CONTINENTAL_FEDERATION","REPRESENTATIVE_FEDERATION","REPRESENTATIVE_GOVERNING_BODY","REPRESENTATIVE_INTERCONTINENTAL_FEDERATION","REPRESENTATIVE_INTERNATIONAL_FEDERATION","REPRESENTATIVE_NATIONAL_FEDERATION","REPRESENTATIVE_REGIONAL_FEDERATION","STAND_IN_MANAGER","TEAM_LEADER","TEAM_MANAGER","TEAM_MEDIA_OFFICER","TECHNICAL_OFFICER","VIDEO_TECHNICIAN","VIDEO_ANALYST","TRANSLATOR","CLUB_OFFICIAL","SPORT_DIRECTOR","CLUB_OFFICIAL_ASSISTANT","LIAISON_OFFICER","YOUTH_COORDINATOR","MATCH_LIAISON","OFFICE_STAFF","PLAYER_CONTRACT_MANAGER","CLUB_IT_OFFICER","REFEREE_LIAISON","REFEREE_OBSERVER_LIAISON","TEAM_COORDINATOR","OFFICIAL_A","OFFICIAL_B","OFFICIAL_C","OFFICIAL_D","OFFICIAL_E"]},"required":false,"in":"query"},"seasonId":{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"status":{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","schema":{"type":"string","enum":["ACTIVE","INACTIVE","PENDING"]},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/roles":{"get":{"tags":["Roles"],"summary":"Get a list of non-match roles","description":"Return a list of roles for the organization (not linked to matches)","operationId":"roles_list_non_fixtures","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/dateFromEnd"},{"$ref":"#/components/parameters/dateFromStart"},{"$ref":"#/components/parameters/dateToEnd"},{"$ref":"#/components/parameters/dateToStart"},{"$ref":"#/components/parameters/entityId"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/nameFamilyLatinStartsWith"},{"$ref":"#/components/parameters/nameFamilyLocalStartsWith"},{"$ref":"#/components/parameters/nameFullLatin"},{"$ref":"#/components/parameters/nameFullLatinContains"},{"$ref":"#/components/parameters/nameFullLocal"},{"$ref":"#/components/parameters/nameFullLocalContains"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/personId"},{"$ref":"#/components/parameters/role"},{"$ref":"#/components/parameters/seasonId"},{"name":"sortBy","description":"Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.","schema":{"type":"string","pattern":"^(\\-?role|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Create a role

> Add a new role

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/roles":{"post":{"tags":["Roles"],"summary":"Create a role","description":"Add a new role","operationId":"roles_insert","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER"],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true}},"title":"role post body","required":["role"]}}}}}}}}
```

## Get a list of match roles

> Return a list of roles for the organization (linked to matches)

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"nameFamilyLatinStartsWith":{"name":"nameFamilyLatinStartsWith","description":"Family latin name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFamilyLocalStartsWith":{"name":"nameFamilyLocalStartsWith","description":"Family local name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatin":{"name":"nameFullLatin","description":"The full name of the person in latin characters","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatinContains":{"name":"nameFullLatinContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLatin=David Johnson nameFullLatinContains=Dav will match nameFullLatinContains=John will match nameFullLatinContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameFullLocal":{"name":"nameFullLocal","description":"The full name of the person","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLocalContains":{"name":"nameFullLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLocal=David Johnson nameFullLocalContains=Dav will match nameFullLocalContains=John will match nameFullLocalContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"role":{"name":"role","description":"Role. Can specify multiple values delimited by comma.\n>- `ADMINISTRATOR_TOURNAMENT` Tournament Administrator\n>- `APPEAL_JURY` Appeal Jury\n>- `APPEAL_JURY_PRESIDENT` Appeal Jury President\n>- `ASSISTANT_REFEREE_1` Assistant Referee 1\n>- `ASSISTANT_REFEREE_2` Assistant Referee 2\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `CLUB_IT_OFFICER` Club IT Officer\n>- `CLUB_OFFICIAL` Club Official\n>- `CLUB_OFFICIAL_ASSISTANT` Substitute for contact person of club\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_GK` Goalkeeper Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strength and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DELEGATE` Delegate\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE` Judge\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `LIAISON_OFFICER` Liaison Officer\n>- `MANAGER` Manager\n>- `MATCH_LIAISON` Match Liaison\n>- `MATCH_MANAGER` Match Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MATCH_SUPERVISOR` Match Supervisor\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_OFFICER` Medical Officer\n>- `MEDICAL_OFFICER_CF` Medical Officer (Continental Federation)\n>- `MEDICAL_OFFICER_FIH` Medical Officer (FIH)\n>- `MEDICAL_STAFF` Medical Staff\n>- `NATIONAL_TOURNAMENT_OFFICIAL` National Tournament Official\n>- `OFFICE_STAFF` Office Staff\n>- `OFFICIAL_A` Official A\n>- `OFFICIAL_B` Official B\n>- `OFFICIAL_C` Official C\n>- `OFFICIAL_D` Official D\n>- `OFFICIAL_E` Official E\n>- `OTHER` Other\n>- `PHYSICAL_TRAINER` Physical Trainer\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PLAYER_CONTRACT_MANAGER` Player Contract Manager\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `PSYCHOLOGIST` Psychologist\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_LIAISON` Referee Liaison\n>- `REFEREE_OBSERVER` Referee Observer\n>- `REFEREE_OBSERVER_LIAISON` Referee Observer Liaison\n>- `REFEREE_RESERVE` Reserve Referee\n>- `REPRESENTATIVE_ASSOCIATION` Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_CONTINENTAL` Continental Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_GOVERNING_BODY` Governing Body Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_INTERCONTINENTAL` Intercontinental Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_INTERNATIONAL` International Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_NATIONAL` National Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_REGIONAL` Regional Association Representative\n>- `REPRESENTATIVE_CONTINENTAL_FEDERATION` Continental Federation Representative\n>- `REPRESENTATIVE_FEDERATION` Federation Representative\n>- `REPRESENTATIVE_GOVERNING_BODY` Governing Body Representative\n>- `REPRESENTATIVE_INTERCONTINENTAL_FEDERATION` Intercontinental Federation Representative\n>- `REPRESENTATIVE_INTERNATIONAL_FEDERATION` International Federation Representative\n>- `REPRESENTATIVE_NATIONAL_FEDERATION` National Federation Representative\n>- `REPRESENTATIVE_REGIONAL_FEDERATION` Regional Federation Representative\n>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SCOUT_1` Scout 1\n>- `SCOUT_2` Scout 2\n>- `SCOUT_3` Scout 3\n>- `SCOUT_SUPERVISOR` Scout Supervisor\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `SPORT_DIRECTOR` Sporting Director\n>- `STAND_IN_MANAGER` Stand-In Manager\n>- `STATISTICIAN` Statistician\n>- `TEAM_COORDINATOR` Team Coordinator\n>- `TEAM_LEADER` Team Leader\n>- `TEAM_MANAGER` Team Manager\n>- `TEAM_MEDIA_OFFICER` Team Media Officer\n>- `TECHNICAL_DELEGATE` Technical Delegate\n>- `TECHNICAL_DELEGATE_ASSISTANT` Assistant Technical Delegate\n>- `TECHNICAL_OFFICER` Technical Officer\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assistant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_ASSISTANT_MANAGER` Assistant Umpire Manager\n>- `UMPIRE_MANAGER` Umpire Manager\n>- `UMPIRE_NATIONAL` National Umpire\n>- `UMPIRE_NEUTRAL` Neutral Umpire\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_ANALYST` Video Analyst\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n>- `YOUTH_COORDINATOR` Youth Coordinator\n","schema":{"type":"string","enum":["ADMINISTRATOR_TOURNAMENT","APPEAL_JURY","APPEAL_JURY_PRESIDENT","ASSISTANT_REFEREE_1","ASSISTANT_REFEREE_2","COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_GK","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DELEGATE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","MATCH_SUPERVISOR","SCOUT_SUPERVISOR","COMMISSIONER","STATISTICIAN","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","SCOUT_1","SCOUT_2","SCOUT_3","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","UMPIRE_MANAGER","UMPIRE_ASSISTANT_MANAGER","UMPIRE_NATIONAL","UMPIRE_NEUTRAL","UMPIRE_RESERVE","UMPIRE_VIDEO","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","REFEREE_OBSERVER","CREW_CHIEF","JUDGE","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_DELEGATE","TECHNICAL_DELEGATE_ASSISTANT","TECHNICAL_OFFICIAL","MATCH_MANAGER","MEDICAL_OFFICER","MEDICAL_OFFICER_CF","MEDICAL_OFFICER_FIH","MEDIA_OFFICER","NATIONAL_TOURNAMENT_OFFICIAL","PHYSICAL_TRAINER","PSYCHOLOGIST","REPRESENTATIVE_ASSOCIATION","REPRESENTATIVE_ASSOCIATION_CONTINENTAL","REPRESENTATIVE_ASSOCIATION_GOVERNING_BODY","REPRESENTATIVE_ASSOCIATION_INTERCONTINENTAL","REPRESENTATIVE_ASSOCIATION_INTERNATIONAL","REPRESENTATIVE_ASSOCIATION_NATIONAL","REPRESENTATIVE_ASSOCIATION_REGIONAL","REPRESENTATIVE_CONTINENTAL_FEDERATION","REPRESENTATIVE_FEDERATION","REPRESENTATIVE_GOVERNING_BODY","REPRESENTATIVE_INTERCONTINENTAL_FEDERATION","REPRESENTATIVE_INTERNATIONAL_FEDERATION","REPRESENTATIVE_NATIONAL_FEDERATION","REPRESENTATIVE_REGIONAL_FEDERATION","STAND_IN_MANAGER","TEAM_LEADER","TEAM_MANAGER","TEAM_MEDIA_OFFICER","TECHNICAL_OFFICER","VIDEO_TECHNICIAN","VIDEO_ANALYST","TRANSLATOR","CLUB_OFFICIAL","SPORT_DIRECTOR","CLUB_OFFICIAL_ASSISTANT","LIAISON_OFFICER","YOUTH_COORDINATOR","MATCH_LIAISON","OFFICE_STAFF","PLAYER_CONTRACT_MANAGER","CLUB_IT_OFFICER","REFEREE_LIAISON","REFEREE_OBSERVER_LIAISON","TEAM_COORDINATOR","OFFICIAL_A","OFFICIAL_B","OFFICIAL_C","OFFICIAL_D","OFFICIAL_E"]},"required":false,"in":"query"},"seasonId":{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"status":{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","schema":{"type":"string","enum":["ACTIVE","INACTIVE","PENDING"]},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/roles/in/fixtures":{"get":{"tags":["Roles"],"summary":"Get a list of match roles","description":"Return a list of roles for the organization (linked to matches)","operationId":"roles_list_fixtures","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/entityId"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/nameFamilyLatinStartsWith"},{"$ref":"#/components/parameters/nameFamilyLocalStartsWith"},{"$ref":"#/components/parameters/nameFullLatin"},{"$ref":"#/components/parameters/nameFullLatinContains"},{"$ref":"#/components/parameters/nameFullLocal"},{"$ref":"#/components/parameters/nameFullLocalContains"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/personId"},{"$ref":"#/components/parameters/role"},{"$ref":"#/components/parameters/seasonId"},{"name":"sortBy","description":"Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.","schema":{"type":"string","pattern":"^(\\-?role|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get a list of roles in a match

> Return a list of roles for a match

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"nameFamilyLatinStartsWith":{"name":"nameFamilyLatinStartsWith","description":"Family latin name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFamilyLocalStartsWith":{"name":"nameFamilyLocalStartsWith","description":"Family local name starts with","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatin":{"name":"nameFullLatin","description":"The full name of the person in latin characters","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLatinContains":{"name":"nameFullLatinContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLatin=David Johnson nameFullLatinContains=Dav will match nameFullLatinContains=John will match nameFullLatinContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"nameFullLocal":{"name":"nameFullLocal","description":"The full name of the person","schema":{"type":"string","maxLength":50},"required":false,"in":"query"},"nameFullLocalContains":{"name":"nameFullLocalContains","description":"Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLocal=David Johnson nameFullLocalContains=Dav will match nameFullLocalContains=John will match nameFullLocalContains=son will not match","schema":{"type":"string","minLength":2,"maxLength":50},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"role":{"name":"role","description":"Role. Can specify multiple values delimited by comma.\n>- `ADMINISTRATOR_TOURNAMENT` Tournament Administrator\n>- `APPEAL_JURY` Appeal Jury\n>- `APPEAL_JURY_PRESIDENT` Appeal Jury President\n>- `ASSISTANT_REFEREE_1` Assistant Referee 1\n>- `ASSISTANT_REFEREE_2` Assistant Referee 2\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `CLUB_IT_OFFICER` Club IT Officer\n>- `CLUB_OFFICIAL` Club Official\n>- `CLUB_OFFICIAL_ASSISTANT` Substitute for contact person of club\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_GK` Goalkeeper Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strength and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DELEGATE` Delegate\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE` Judge\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `LIAISON_OFFICER` Liaison Officer\n>- `MANAGER` Manager\n>- `MATCH_LIAISON` Match Liaison\n>- `MATCH_MANAGER` Match Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MATCH_SUPERVISOR` Match Supervisor\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_OFFICER` Medical Officer\n>- `MEDICAL_OFFICER_CF` Medical Officer (Continental Federation)\n>- `MEDICAL_OFFICER_FIH` Medical Officer (FIH)\n>- `MEDICAL_STAFF` Medical Staff\n>- `NATIONAL_TOURNAMENT_OFFICIAL` National Tournament Official\n>- `OFFICE_STAFF` Office Staff\n>- `OFFICIAL_A` Official A\n>- `OFFICIAL_B` Official B\n>- `OFFICIAL_C` Official C\n>- `OFFICIAL_D` Official D\n>- `OFFICIAL_E` Official E\n>- `OTHER` Other\n>- `PHYSICAL_TRAINER` Physical Trainer\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PLAYER_CONTRACT_MANAGER` Player Contract Manager\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `PSYCHOLOGIST` Psychologist\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_LIAISON` Referee Liaison\n>- `REFEREE_OBSERVER` Referee Observer\n>- `REFEREE_OBSERVER_LIAISON` Referee Observer Liaison\n>- `REFEREE_RESERVE` Reserve Referee\n>- `REPRESENTATIVE_ASSOCIATION` Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_CONTINENTAL` Continental Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_GOVERNING_BODY` Governing Body Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_INTERCONTINENTAL` Intercontinental Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_INTERNATIONAL` International Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_NATIONAL` National Association Representative\n>- `REPRESENTATIVE_ASSOCIATION_REGIONAL` Regional Association Representative\n>- `REPRESENTATIVE_CONTINENTAL_FEDERATION` Continental Federation Representative\n>- `REPRESENTATIVE_FEDERATION` Federation Representative\n>- `REPRESENTATIVE_GOVERNING_BODY` Governing Body Representative\n>- `REPRESENTATIVE_INTERCONTINENTAL_FEDERATION` Intercontinental Federation Representative\n>- `REPRESENTATIVE_INTERNATIONAL_FEDERATION` International Federation Representative\n>- `REPRESENTATIVE_NATIONAL_FEDERATION` National Federation Representative\n>- `REPRESENTATIVE_REGIONAL_FEDERATION` Regional Federation Representative\n>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SCOUT_1` Scout 1\n>- `SCOUT_2` Scout 2\n>- `SCOUT_3` Scout 3\n>- `SCOUT_SUPERVISOR` Scout Supervisor\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `SPORT_DIRECTOR` Sporting Director\n>- `STAND_IN_MANAGER` Stand-In Manager\n>- `STATISTICIAN` Statistician\n>- `TEAM_COORDINATOR` Team Coordinator\n>- `TEAM_LEADER` Team Leader\n>- `TEAM_MANAGER` Team Manager\n>- `TEAM_MEDIA_OFFICER` Team Media Officer\n>- `TECHNICAL_DELEGATE` Technical Delegate\n>- `TECHNICAL_DELEGATE_ASSISTANT` Assistant Technical Delegate\n>- `TECHNICAL_OFFICER` Technical Officer\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assistant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_ASSISTANT_MANAGER` Assistant Umpire Manager\n>- `UMPIRE_MANAGER` Umpire Manager\n>- `UMPIRE_NATIONAL` National Umpire\n>- `UMPIRE_NEUTRAL` Neutral Umpire\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_ANALYST` Video Analyst\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n>- `YOUTH_COORDINATOR` Youth Coordinator\n","schema":{"type":"string","enum":["ADMINISTRATOR_TOURNAMENT","APPEAL_JURY","APPEAL_JURY_PRESIDENT","ASSISTANT_REFEREE_1","ASSISTANT_REFEREE_2","COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_GK","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DELEGATE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","MATCH_SUPERVISOR","SCOUT_SUPERVISOR","COMMISSIONER","STATISTICIAN","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","SCOUT_1","SCOUT_2","SCOUT_3","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","UMPIRE_MANAGER","UMPIRE_ASSISTANT_MANAGER","UMPIRE_NATIONAL","UMPIRE_NEUTRAL","UMPIRE_RESERVE","UMPIRE_VIDEO","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","REFEREE_OBSERVER","CREW_CHIEF","JUDGE","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_DELEGATE","TECHNICAL_DELEGATE_ASSISTANT","TECHNICAL_OFFICIAL","MATCH_MANAGER","MEDICAL_OFFICER","MEDICAL_OFFICER_CF","MEDICAL_OFFICER_FIH","MEDIA_OFFICER","NATIONAL_TOURNAMENT_OFFICIAL","PHYSICAL_TRAINER","PSYCHOLOGIST","REPRESENTATIVE_ASSOCIATION","REPRESENTATIVE_ASSOCIATION_CONTINENTAL","REPRESENTATIVE_ASSOCIATION_GOVERNING_BODY","REPRESENTATIVE_ASSOCIATION_INTERCONTINENTAL","REPRESENTATIVE_ASSOCIATION_INTERNATIONAL","REPRESENTATIVE_ASSOCIATION_NATIONAL","REPRESENTATIVE_ASSOCIATION_REGIONAL","REPRESENTATIVE_CONTINENTAL_FEDERATION","REPRESENTATIVE_FEDERATION","REPRESENTATIVE_GOVERNING_BODY","REPRESENTATIVE_INTERCONTINENTAL_FEDERATION","REPRESENTATIVE_INTERNATIONAL_FEDERATION","REPRESENTATIVE_NATIONAL_FEDERATION","REPRESENTATIVE_REGIONAL_FEDERATION","STAND_IN_MANAGER","TEAM_LEADER","TEAM_MANAGER","TEAM_MEDIA_OFFICER","TECHNICAL_OFFICER","VIDEO_TECHNICIAN","VIDEO_ANALYST","TRANSLATOR","CLUB_OFFICIAL","SPORT_DIRECTOR","CLUB_OFFICIAL_ASSISTANT","LIAISON_OFFICER","YOUTH_COORDINATOR","MATCH_LIAISON","OFFICE_STAFF","PLAYER_CONTRACT_MANAGER","CLUB_IT_OFFICER","REFEREE_LIAISON","REFEREE_OBSERVER_LIAISON","TEAM_COORDINATOR","OFFICIAL_A","OFFICIAL_B","OFFICIAL_C","OFFICIAL_D","OFFICIAL_E"]},"required":false,"in":"query"},"status":{"name":"status","description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","schema":{"type":"string","enum":["ACTIVE","INACTIVE","PENDING"]},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/fixtures/{fixtureId}/roles":{"get":{"tags":["Roles"],"summary":"Get a list of roles in a match","description":"Return a list of roles for a match","operationId":"roles_list_by_fixture","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/entityId"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/nameFamilyLatinStartsWith"},{"$ref":"#/components/parameters/nameFamilyLocalStartsWith"},{"$ref":"#/components/parameters/nameFullLatin"},{"$ref":"#/components/parameters/nameFullLatinContains"},{"$ref":"#/components/parameters/nameFullLocal"},{"$ref":"#/components/parameters/nameFullLocalContains"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/personId"},{"$ref":"#/components/parameters/role"},{"name":"sortBy","description":"Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.","schema":{"type":"string","pattern":"^(\\-?role|,)*$"},"required":false,"in":"query"},{"$ref":"#/components/parameters/status"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Delete all a role

> Delete all role

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"forceDelete":{"name":"forceDelete","description":"Force a delete command to run and delete child records as well if there are existing records depending on the record.","schema":{"type":"boolean"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/fixtures/{fixtureId}/roles":{"delete":{"tags":["Roles"],"summary":"Delete all a role","description":"Delete all role","operationId":"role_all_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/forceDelete"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}]}}}}
```

## Get a role

> Return detailed information about a specific role

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/roles/{roleId}":{"get":{"tags":["Roles"],"summary":"Get a role","description":"Return detailed information about a specific role","operationId":"roles_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"roleId","description":"The unique identifier of the role","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```

## Update a role

> Change the information of a specific role

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/roles/{roleId}":{"put":{"tags":["Roles"],"summary":"Update a role","description":"Change the information of a specific role","operationId":"roles_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"roleId","description":"The unique identifier of the role","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER"],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true}},"title":"role put body"}}}}}}}}
```

## Delete a role

> Delete a specific role

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Roles","description":"A person can be assigned a role inside an organization, team or match.  This is the job, position or responsibility they hold.\nThe routes allow roles to be returned that are linked to matches or not.\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run.  If your token does not possess the correct scope then you will be unable to make the API call."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter.  It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"RolesModel":{"type":"object","additionalProperties":false,"properties":{"roleId":{"description":"The unique identifier of the role","type":"string","format":"uuid"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this role belongs to","type":"object"},"entityGroupId":{"description":"The club that this team belongs to","type":"string","format":"uuid","nullable":true},"entityGroup":{"properties":{"resourceType":{"type":"string","enum":["entityGroups"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The club that this team belongs to","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"seasonId":{"description":"The unique identifier of the season","type":"string","format":"uuid","nullable":true},"season":{"properties":{"resourceType":{"type":"string","enum":["seasons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The season linked to this record","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid","nullable":true},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"status":{"description":"Status\n>- `ACTIVE` Active\n>- `INACTIVE` Inactive\n>- `PENDING` Pending\n","type":"string","enum":["ACTIVE","INACTIVE","PENDING"],"maxLength":30},"dateFrom":{"description":"Date the role started (Not for a role within a match)","type":"string","format":"date","nullable":true},"dateTo":{"description":"Date the role ended (Not for a role within a match)","type":"string","format":"date","nullable":true},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"roleNumber":{"description":"Number within the role. eg: Assistant Coach 2","type":"integer","format":"int32","nullable":true},"role":{"description":"Role\n>- None None\n>- `CAPTAIN` Captain\n>- `CAPTAIN_VICE` Vice Captain\n>- `CEO` CEO\n>- `COACH` Coach\n>- `COACH_ASSISTANT` Assistant Coach\n>- `COACH_ASSISTANT_HEAD` Assistant Head Coach\n>- `COACH_ASSOCIATE_HEAD` Associate Head Coach\n>- `COACH_DEVELOPMENT` Development Coach\n>- `COACH_HEAD` Head Coach\n>- `COACH_HEAD_INTERIM` Interim Head Coach\n>- `COACH_OTHER` Other coaching staff\n>- `COACH_SC` Strengh and Conditioning Coach\n>- `COACH_SENIOR` Senior Coach\n>- `COACH_SPECIALIST` Specialist Coach\n>- `COMMISSIONER` Commissioner\n>- `COMMITTEE` Committee\n>- `CREW_CHIEF` Crew Chief\n>- `DIRECTOR` Director\n>- `DOCTOR` Doctor\n>- `GENERAL` General\n>- `GROUNDSKEEPER` Groundskeeper\n>- `JUDGE_SCORING` Scoring Judge (SJ)\n>- `JUDGE_TIMING` Timing Judge (TJ)\n>- `MANAGER` Manager\n>- `MATCH_OFFICIAL` Match Official\n>- `MEDIA_OFFICER` Media Officer\n>- `MEDICAL_STAFF` Medical Staff\n>- `OTHER` Other\n>- `PHYSIOTHERAPIST` Physiotherapist\n>- `PRESIDENT` President\n>- `PRESIDENT_VICE` Vice President\n>- `REFEREE` Referee\n>- `REFEREE_ASSISTANT` Referee Assistant\n>- `REFEREE_ASSISTANT_RESERVE` Reserve Assistant Referee\n>- `REFEREE_RESERVE` Reserve Referee\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `SHOT_CLOCK_OPERATOR` Shot Clock Operator\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\n>- `UMPIRE_1` Umpire 1\n>- `UMPIRE_2` Umpire 2\n>- `UMPIRE_RESERVE` Reserve Umpire (RU)\n>- `UMPIRE_VIDEO` Video Umpire (VU)\n>- `VIDEO_TECHNICIAN` Video Technician (VT)\n","type":"string","enum":["COACH","COACH_HEAD","COACH_HEAD_INTERIM","COACH_ASSISTANT","COACH_ASSISTANT_HEAD","COACH_ASSOCIATE_HEAD","COACH_SC","COACH_SENIOR","COACH_DEVELOPMENT","COACH_SPECIALIST","COACH_OTHER","CAPTAIN","CAPTAIN_VICE","DOCTOR","PHYSIOTHERAPIST","MEDICAL_STAFF","TRAINER","TRAINER_ASSISTANT","MATCH_OFFICIAL","COMMISSIONER","STATISTICIAN","SCORER","SCORER_ASSISTANT","SHOT_CLOCK_OPERATOR","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","UMPIRE_1","UMPIRE_2","REFEREE_ASSISTANT","REFEREE_RESERVE","REFEREE_ASSISTANT_RESERVE","CREW_CHIEF","UMPIRE_RESERVE","UMPIRE_VIDEO","JUDGE_SCORING","JUDGE_TIMING","TECHNICAL_OFFICIAL","VIDEO_TECHNICIAN","TRANSLATOR","MEDIA_OFFICER",null],"maxLength":100},"roleSubType":{"description":"Role sub type","type":"string","maxLength":100,"nullable":true},"externalId":{"description":"The Id of the data as set by the provider of the data","type":"string","maxLength":150,"pattern":"^[0-9A-Za-z/_-]+$","nullable":true},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"role model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.  If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display.  The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"forceDelete":{"name":"forceDelete","description":"Force a delete command to run and delete child records as well if there are existing records depending on the record.","schema":{"type":"boolean"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/basketball/o/{organizationId}/roles/{roleId}":{"delete":{"tags":["Roles"],"summary":"Delete a role","description":"Delete a specific role","operationId":"role_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Roles Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/RolesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/forceDelete"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"roleId","description":"The unique identifier of the role","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"}]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportradar.com/datacore/sports-apis/basketball/datacore-api-v1/roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.