# 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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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 entity","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"},"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":{"/basketball33/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/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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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":{"/basketball33/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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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 entity","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"},"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":{"/basketball33/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/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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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 entity","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"},"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":{"/basketball33/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 fixture","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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":{"/basketball33/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 fixture","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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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"},"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":{"/basketball33/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/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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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":{"/basketball33/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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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  - 3x3 basketball3","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>- `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>- `SCOREKEEPER` Scorekeeper\n>- `SCOREKEEPER_ASSISTANT` Assistant Scorekeeper\n>- `SCORER` Scorer\n>- `SCORER_ASSISTANT` Assistant Scorer\n>- `SECRETARY` Secretary\n>- `STATISTICIAN` Statistician\n>- `TECHNICAL_OFFICIAL` Technical Official (TO)\n>- `TIMEKEEPER` Timekeeper\n>- `TIMER` Timer\n>- `TRAINER` Trainer\n>- `TRAINER_ASSISTANT` Assitant Trainer\n>- `TRANSLATOR` Translator\n>- `TREASURER` Treasurer\n>- `UMPIRE` Umpire\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","SCOREKEEPER","SCOREKEEPER_ASSISTANT","TIMEKEEPER","SCORER","SCORER_ASSISTANT","TIMER","GROUNDSKEEPER","CEO","COMMITTEE","PRESIDENT","DIRECTOR","PRESIDENT_VICE","SECRETARY","TREASURER","MANAGER","GENERAL","OTHER","REFEREE","UMPIRE","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},"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":{"/basketball33/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"}]}}}}
```
