# Images

An image can be assigned to different objects in the system.

Images can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.

Images can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types. In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~~entityId~~.

### Image Types

There are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are

* `LOGO` (This type if valid for all objects except PERSON.) This is the logo of the organization.\\

* `LOGO_ALTERNATE` (This type if valid for all objects except PERSON.) This is an alternate version of the logo. This may be better suited to a light/dark background as compared to the LOGO version.\\

* `LOGO_BACKGROUND` (This type if valid for all objects except PERSON.) This is the logo of the organization in a format that can be used for background purposes. This would generally be a stylised version of the logo.\\

* `PERSON_HEAD` (Only valid for the person type). This is a photo of a person from the shoulders up. This should include the shoulders.\\

* `PERSON_WAIST` (Only valid for the person type). This is a photo of a person from the waist up.\\

* `PERSON_POSE` (Only valid for the person type). This is a photo of a person where they are posing in some position. This could be a full body image or from the waist up.\\

* `TEAM_PHOTO` (Only valid for the entity type). This is a photo of a team in a season.\\

### Format

Images can be uploaded in any of the following formats:

* `images/jpeg`
* `images/png`

**PNG files with an alpha channel are the preferred format.**

**File Size**: Images can be a maxiumum of 2Mb in size

**Dimensions**: Images being uploaded should be **square** (eg 400x400) and be >= 100x100

### Ratings

All images are given a rating when they are uploaded. All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency. Images are only marked as HIGH if they have been manually reviewed.

## Get a list of images

> Return a list of images for the type

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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"},"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"},"imageType":{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"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"},"rating":{"name":"rating","description":"Media Rating\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n>- `UNKNOWN` Uknown\n","schema":{"type":"string","enum":["UNKNOWN","LOW","MEDIUM","HIGH"],"maxLength":100},"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":{"/icehockey/o/{organizationId}/images/for/{baseType}":{"get":{"tags":["Images"],"summary":"Get a list of images","description":"Return a list of images for the type","operationId":"images_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/imageType"},{"$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"},{"$ref":"#/components/parameters/rating"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get a list of images for a fixture

> Return a list of images for the fixture

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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"},"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"},"rating":{"name":"rating","description":"Media Rating\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n>- `UNKNOWN` Uknown\n","schema":{"type":"string","enum":["UNKNOWN","LOW","MEDIUM","HIGH"],"maxLength":100},"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":{"/icehockey/o/{organizationId}/images/for/FIXTURE/{fixtureId}":{"get":{"tags":["Images"],"summary":"Get a list of images for a fixture","description":"Return a list of images for the fixture","operationId":"images_for_fixture_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"baseType","description":"Base Type. Multiple allowed (comma-delimited).\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":false,"in":"query"},{"$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"},{"name":"imageType","description":"Upload Type. Multiple allowed (comma-delimited).\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":false,"in":"query"},{"$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"},{"$ref":"#/components/parameters/rating"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get a list of images for the Organization

> Return a list of images for the Organization

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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"},"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"},"imageType":{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"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"},"rating":{"name":"rating","description":"Media Rating\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n>- `UNKNOWN` Uknown\n","schema":{"type":"string","enum":["UNKNOWN","LOW","MEDIUM","HIGH"],"maxLength":100},"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":{"/icehockey/o/{organizationId}/images/for/ORGANIZATION":{"get":{"tags":["Images"],"summary":"Get a list of images for the Organization","description":"Return a list of images for the Organization","operationId":"images_list_organization","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100,"default":"ORGANIZATION"},"required":false,"in":"query"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/imageType"},{"$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"},{"$ref":"#/components/parameters/rating"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get a list of images for a specific type and id

> Return a list of images for the type and id

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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"},"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"},"imageType":{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"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"},"rating":{"name":"rating","description":"Media Rating\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n>- `UNKNOWN` Uknown\n","schema":{"type":"string","enum":["UNKNOWN","LOW","MEDIUM","HIGH"],"maxLength":100},"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":{"/icehockey/o/{organizationId}/images/for/{baseType}/{baseId}":{"get":{"tags":["Images"],"summary":"Get a list of images for a specific type and id","description":"Return a list of images for the type and id","operationId":"images_list_id","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"baseId","description":"The unique identifier of the object associated with this record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/imageType"},{"$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"},{"$ref":"#/components/parameters/rating"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get a list of images for a type in a secondary Type

> Return a list of images assigned to type for a secondary type and Id

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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"},"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"},"imageType":{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"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"},"rating":{"name":"rating","description":"Media Rating\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n>- `UNKNOWN` Uknown\n","schema":{"type":"string","enum":["UNKNOWN","LOW","MEDIUM","HIGH"],"maxLength":100},"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":{"/icehockey/o/{organizationId}/images/for/{baseType}/in/{secondaryType}/{secondaryId}":{"get":{"tags":["Images"],"summary":"Get a list of images for a type in a secondary Type","description":"Return a list of images assigned to type for a secondary type and Id","operationId":"images_list_secondary","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/imageType"},{"$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"},{"$ref":"#/components/parameters/rating"},{"name":"secondaryId","description":"The unique identifier of the secondary object associated with this image record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"secondaryType","description":"Media Secondary Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `SEASON` Season\n","schema":{"type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get a list of images for a specific base and secondary id

> Return a list of images for the base id for a secondary id

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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"},"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"},"imageType":{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"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"},"rating":{"name":"rating","description":"Media Rating\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n>- `UNKNOWN` Uknown\n","schema":{"type":"string","enum":["UNKNOWN","LOW","MEDIUM","HIGH"],"maxLength":100},"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":{"/icehockey/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}":{"get":{"tags":["Images"],"summary":"Get a list of images for a specific base and secondary id","description":"Return a list of images for the base id for a secondary id","operationId":"images_list_id_secondary","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"baseId","description":"The unique identifier of the object associated with this record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/imageType"},{"$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"},{"$ref":"#/components/parameters/rating"},{"name":"secondaryId","description":"The unique identifier of the secondary object associated with this image record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"secondaryType","description":"Media Secondary Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `SEASON` Season\n","schema":{"type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/updated"}]}}}}
```

## Get an image

> Return detailed information about a specific image

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/{imageId}":{"get":{"tags":["Images"],"summary":"Get an image","description":"Return detailed information about a specific image","operationId":"images_detail","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageId","description":"The unique identifier of the image record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$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"}]}}}}
```

## Delete an image

> Delete an image

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/{imageId}":{"delete":{"tags":["Images"],"summary":"Delete an image","description":"Delete an image","operationId":"images_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/forceDelete"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageId","description":"The unique identifier of the image record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}]}}}}
```

## Update the rating for an image

> Set the rating for an image

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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:image_rating"]}],"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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/{imageId}/rating":{"put":{"tags":["Images"],"summary":"Update the rating for an image","description":"Set the rating for an image","operationId":"images_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageId","description":"The unique identifier of the image record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$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":{"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100}},"title":"images put body"}}}}}}}}
```

## Upload a new image

> \
> You can upload the image in one of two ways:\
> \
> \- A binary blob in the POST data\
> \- A 'file' field in a multipart/form-data\
> \
> \
> \*\*Binary Blob\*\*\
> \
> Upload the image by supplying the image as binary in the POST data.\
> \
> The HTTP request would look like\
> \
> &#x20;   POST /v1/icehockey/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON\_HEAD\
> &#x20;   Host: example.com\
> &#x20;   Authorization: Bearer some-token\
> &#x20;   Content-Length: 808\
> &#x20;   Content-Type: image/png\
> \
> &#x20;   \[file content goes there]\
> \
> \
> \*\*Multi-part form\*\*\
> \
> Upload the image by supplying it as a 'file' field in a multipart form.\
> The file field must be called \`filedata\` and the content-type must be set to \`multipart/form-data\`\
> \
> \*\*Note\*\*: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\\

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType}":{"post":{"tags":["Images"],"summary":"Upload a new image","description":"\nYou can upload the image in one of two ways:\n\n- A binary blob in the POST data\n- A 'file' field in a multipart/form-data\n\n\n**Binary Blob**\n\nUpload the image by supplying the image as binary in the POST data.\n\nThe HTTP request would look like\n\n    POST /v1/icehockey/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON_HEAD\n    Host: example.com\n    Authorization: Bearer some-token\n    Content-Length: 808\n    Content-Type: image/png\n\n    [file content goes there]\n\n\n**Multi-part form**\n\nUpload the image by supplying it as a 'file' field in a multipart form.\nThe file field must be called `filedata` and the content-type must be set to `multipart/form-data`\n\n**Note**: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\n","operationId":"images_insert","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"baseId","description":"The unique identifier of the object associated with this record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$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/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}}}
```

## Upload a new image from a URL

> This method allows a new image to uploaded by providing a URL where the image can be downloaded from.\
> \
> \*\*Note\*\*: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\\

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType}/fromURL":{"post":{"tags":["Images"],"summary":"Upload a new image from a URL","description":"This method allows a new image to uploaded by providing a URL where the image can be downloaded from.\n\n**Note**: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\n","operationId":"images_insert_from_url","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"baseId","description":"The unique identifier of the object associated with this record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$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":{"url":{"description":"The URL of the image","type":"string","maxLength":250}},"title":"images post body","required":["url"]}}}}}}}}
```

## Upload a new image in a secondary type

> Add a new image for a type in a secondary type.\
> You can upload the image in one of two ways:\
> \
> \- A binary blob in the POST data\
> \- A 'file' field in a multipart/form-data\
> \
> \
> \*\*Binary Blob\*\*\
> \
> Upload the image by supplying the image as binary in the POST data.\
> \
> The HTTP request would look like\
> \
> &#x20;   POST /v1/icehockey/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON\_HEAD\
> &#x20;   Host: example.com\
> &#x20;   Authorization: Bearer some-token\
> &#x20;   Content-Length: 808\
> &#x20;   Content-Type: image/png\
> \
> &#x20;   \[file content goes there]\
> \
> \
> \*\*Multi-part form\*\*\
> \
> Upload the image by supplying it as a 'file' field in a multipart form.\
> The file field must be called \`filedata\` and the content-type must be set to \`multipart/form-data\`\
> \
> \*\*Note\*\*: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\\

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType}":{"post":{"tags":["Images"],"summary":"Upload a new image in a secondary type","description":"Add a new image for a type in a secondary type.\nYou can upload the image in one of two ways:\n\n- A binary blob in the POST data\n- A 'file' field in a multipart/form-data\n\n\n**Binary Blob**\n\nUpload the image by supplying the image as binary in the POST data.\n\nThe HTTP request would look like\n\n    POST /v1/icehockey/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON_HEAD\n    Host: example.com\n    Authorization: Bearer some-token\n    Content-Length: 808\n    Content-Type: image/png\n\n    [file content goes there]\n\n\n**Multi-part form**\n\nUpload the image by supplying it as a 'file' field in a multipart form.\nThe file field must be called `filedata` and the content-type must be set to `multipart/form-data`\n\n**Note**: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\n","operationId":"images_insert_secondary","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"baseId","description":"The unique identifier of the object associated with this record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$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":"secondaryId","description":"The unique identifier of the secondary object associated with this image record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"secondaryType","description":"Media Secondary Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `SEASON` Season\n","schema":{"type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE"],"maxLength":100},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}}}
```

## Upload a new image in a secondary type from a URL

> This method allows a new image to be uploaded against a secondary type by providing a URL where the image can be downloaded from.\
> \
> \*\*Note\*\*: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\\

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType}/fromURL":{"post":{"tags":["Images"],"summary":"Upload a new image in a secondary type from a URL","description":"This method allows a new image to be uploaded against a secondary type by providing a URL where the image can be downloaded from.\n\n**Note**: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\n","operationId":"images_insert_secondary_from_url","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"baseId","description":"The unique identifier of the object associated with this record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$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":"secondaryId","description":"The unique identifier of the secondary object associated with this image record","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"secondaryType","description":"Media Secondary Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `SEASON` Season\n","schema":{"type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE"],"maxLength":100},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"description":"The URL of the image","type":"string","maxLength":250}},"title":"images post body","required":["url"]}}}}}}}}
```

## Upload a new image for the organization

> Add a new image for the organization.\
> You can upload the image in one of two ways:\
> \
> \- A binary blob in the POST data\
> \- A 'file' field in a multipart/form-data\
> \
> \
> \*\*Binary Blob\*\*\
> \
> Upload the image by supplying the image as binary in the POST data.\
> \
> The HTTP request would look like\
> \
> &#x20;   POST /v1/icehockey/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON\_HEAD\
> &#x20;   Host: example.com\
> &#x20;   Authorization: Bearer some-token\
> &#x20;   Content-Length: 808\
> &#x20;   Content-Type: image/png\
> \
> &#x20;   \[file content goes there]\
> \
> \
> \*\*Multi-part form\*\*\
> \
> Upload the image by supplying it as a 'file' field in a multipart form.\
> The file field must be called \`filedata\` and the content-type must be set to \`multipart/form-data\`\
> \
> \*\*Note\*\*: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\\

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/for/ORGANIZATION/{imageType}":{"post":{"tags":["Images"],"summary":"Upload a new image for the organization","description":"Add a new image for the organization.\nYou can upload the image in one of two ways:\n\n- A binary blob in the POST data\n- A 'file' field in a multipart/form-data\n\n\n**Binary Blob**\n\nUpload the image by supplying the image as binary in the POST data.\n\nThe HTTP request would look like\n\n    POST /v1/icehockey/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON_HEAD\n    Host: example.com\n    Authorization: Bearer some-token\n    Content-Length: 808\n    Content-Type: image/png\n\n    [file content goes there]\n\n\n**Multi-part form**\n\nUpload the image by supplying it as a 'file' field in a multipart form.\nThe file field must be called `filedata` and the content-type must be set to `multipart/form-data`\n\n**Note**: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\n","operationId":"images_insert_organization","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100,"default":"ORGANIZATION"},"required":false,"in":"query"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$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/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}}}
```

## Upload a new image for the organization from a URL

> This method allows a new image to be uploaded against the organization type by providing a URL where the image can be downloaded from.\
> \
> \*\*Note\*\*: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\\

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - Ice Hockey","version":"v1"},"tags":[{"name":"Images","description":"An image can be assigned to different objects in the system.\n\nImages can be assigned to an object by specifying the type of the object `baseType` and it's unique identifier `baseId`. For a person the `baseId` would be the value of the `personId` field for that person.\n\nImages can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types.  In this instance the `secondaryType` would be `ENTITY` and the `secondaryId` the value of the ~entityId~.\n\n## Image Types\nThere are multiple different types of `imageTypes`. Some are valid for only certain `baseTypes` The image types are\n - `LOGO`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization. <br><img src=\"public/image-logo.png\" class = \"image-sample\">\n - `LOGO_ALTERNATE`\n    (This type if valid for all objects except PERSON.)  This is an alternate version of the logo.  This may be better suited to a light/dark background as compared to the LOGO version. <br><img src=\"public/image-logo-alternate.png\" class = \"image-sample\">\n - `LOGO_BACKGROUND`\n    (This type if valid for all objects except PERSON.)  This is the logo of the organization in a format that can be used for background purposes.  This would generally be a stylised version of the logo. <br><img src=\"public/image-logo-background.png\" class = \"image-sample\">\n - `PERSON_HEAD`\n    (Only valid for the person type).  This is a photo of a person from the shoulders up.  This should include the shoulders.  <br><img src=\"public/image-person-head.png\" class = \"image-sample\">\n - `PERSON_WAIST`\n    (Only valid for the person type).  This is a photo of a person from the waist up.  <br><img src=\"public/image-person-waist.png\" class = \"image-sample\">\n - `PERSON_POSE`\n    (Only valid for the person type).  This is a photo of a person where they are posing in some position.  This could be a full body image or from the waist up. <br><img src=\"public/image-person-pose.png\" class = \"image-sample\">\n - `TEAM_PHOTO`\n    (Only valid for the entity type).  This is a photo of a team in a season. <br><img src=\"public/team-photo.png\" class = \"image-sample\">\n\n\n## Format\n\nImages can be uploaded in any of the following formats:\n\n- `images/jpeg`\n- `images/png`\n\n**PNG files with an alpha channel are the preferred format.**\n\n**File Size**: Images can be a maxiumum of 2Mb in size\n\n**Dimensions**:\nImages being uploaded should be **square** (eg 400x400) and be >= 100x100\n\n## Ratings\nAll images are given a rating when they are uploaded.  All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency.  Images are only marked as HIGH if they have been manually reviewed.\n\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"}}}}}},"ImagesModel":{"type":"object","additionalProperties":false,"properties":{"imageId":{"description":"The unique identifier of the image record","type":"string","format":"uuid","readOnly":true},"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 images belongs to","type":"object"},"baseType":{"description":"The object that this image relates to\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"baseId":{"description":"The unique identifier of the object associated with this image's record. If the `baseType` is `PERSON` then this would be the value of `personId`.","type":"string","format":"uuid"},"fileType":{"description":"The type of file\n>- `JPG` jpg\n>- `PNG` png\n>- `SVG` svg\n","type":"string","enum":["JPG","PNG","SVG"],"maxLength":3,"readOnly":true},"imageType":{"description":"Upload Type\n>- `LOGO` Logo - Not valid for 'PERSON' baseType\n>- `LOGO_ALTERNATE` Logo (alternate) - Not valid for 'PERSON' baseType\n>- `LOGO_BACKGROUND` Stylised logo for background purposes - Not valid for 'PERSON' baseType\n>- `PERSON_HEAD` Head shot (shoulders and head) - Only valid for 'PERSON' baseType\n>- `PERSON_POSE` Person posing - Only valid for 'PERSON' baseType\n>- `PERSON_WAIST` Head shot from the waist up - Only valid for 'PERSON' baseType\n>- `TEAM_PHOTO` Team Photo - Only valid for 'ENTITY' baseType\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","type":"string","enum":["LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","PERSON_HEAD","PERSON_WAIST","PERSON_POSE","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"secondaryType":{"description":"If the image relates to a secondary object. Such as a photo of a person in a team, then baseType would be PERSON and secondaryType would be TEAM.\n>- None None\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `SEASON` Season\n","type":"string","enum":["ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","DIVISION","CONFERENCE",null],"maxLength":100,"nullable":true},"secondaryId":{"description":"The unique identifier of the object associated with the secondaryType","type":"string","format":"uuid"},"rating":{"description":"The rating given to the quality of the image.  All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency.  Images are only marked as HIGH if they have been manually reviewed.  You should take your use-case into account when you go to use the image.\n>- `HIGH` High\n>- `LOW` Low\n>- `MEDIUM` Medium\n","type":"string","enum":["LOW","MEDIUM","HIGH"],"maxLength":100,"readOnly":true},"url":{"description":"The URL of the image. See [Images](#section/Introduction/Images) for more information.","type":"string","readOnly":true},"maximumHeight":{"description":"The maximum height (in pixels) of this image.","type":"integer","format":"int32","readOnly":true},"maximumWidth":{"description":"The maximum width (in pixels) of this image.","type":"integer","format":"int32","readOnly":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":"images 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":{"/icehockey/o/{organizationId}/images/for/ORGANIZATION/{imageType}/fromURL":{"post":{"tags":["Images"],"summary":"Upload a new image for the organization from a URL","description":"This method allows a new image to be uploaded against the organization type by providing a URL where the image can be downloaded from.\n\n**Note**: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.\n","operationId":"images_insert_organization_from_url","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Images 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/ImagesModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"baseType","description":"Media Base Type\n>- `COMPETITION` Competition\n>- `CONFERENCE` Conference\n>- `DIVISION` Division\n>- `ENTITY` Entity\n>- `ENTITYGROUP` Entity Group\n>- `LEAGUE` League\n>- `ORGANIZATION` Organization\n>- `PERSON` Person\n>- `SEASON` Season\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON","ENTITY","ENTITYGROUP","COMPETITION","SEASON","LEAGUE","ORGANIZATION","DIVISION","CONFERENCE","UNIFORM","UNIFORM_ITEM"],"maxLength":100,"default":"ORGANIZATION"},"required":false,"in":"query"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"name":"imageType","description":"Upload Type\n>- `LOGO` Logo\n>- `LOGO_ALTERNATE` Logo - Alternate\n>- `LOGO_BACKGROUND` Logo Background\n>- `PERSON_HEAD` Head photo\n>- `PERSON_POSE` Posing photo\n>- `PERSON_WAIST` Waist and Head photo\n>- `TEAM_PHOTO` Team Photo\n>- `UNIFORM` Uniform\n>- `UNIFORM_ITEM` Uniform Item\n","schema":{"type":"string","enum":["PERSON_HEAD","PERSON_WAIST","PERSON_POSE","LOGO","LOGO_ALTERNATE","LOGO_BACKGROUND","TEAM_PHOTO","UNIFORM","UNIFORM_ITEM"],"maxLength":100},"required":true,"in":"path"},{"$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":{"url":{"description":"The URL of the image","type":"string","maxLength":250}},"title":"images post body","required":["url"]}}}}}}}}
```
