Edit an Eligibility Subscription
PATCH/v1/eligibility-subscriptions/:id
Update an Eligibility Subscription's metadata.
Request​
Path Parameters
Id of the Eligibility Subscription.
- application/json
Body
required
metadata object
Metadata object that will be merged with current metadata object.
Max key size is 40 characters. If key matches already existing key, it will override old value
Responses​
- 200
- 400
- 401
- 403
- 404
Successfully updates Eligibility Subscription's metadata
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
- Array [
- ]
data object
suggestedActivitySubTags object[]nullable
SubTag name
tag object
Tag name
Tag description
SubTag description
Possible values: [live
, pending_validation_request
, validation_request_failed
, pending
, cancelled
, cannot_define_eligibility
]
results object
Possible values: [pass
, fail
]
confirmedActivitySubTags object[]nullable
SubTag name
tag object
Tag name
Tag description
SubTag description
rejectedActivitySubTags object[]nullable
Confirmed organisation's activity subtags that are not allowed in partner's configuration
SubTag name
tag object
Tag name
Tag description
SubTag description
{
"data": {
"id": "eligibilitysubscription_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"organisationId": "organisation_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"organisationName": "string",
"partnerId": "string",
"configurationId": "string",
"validationRequestId": "validationrequest_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"suggestedActivitySubTags": [
{
"id": "activitysubtag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name": "Sport school",
"tag": {
"id": "activitytag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name": "Education",
"description": "string",
"createdAt": "2020-10-13T17:46:54.000Z",
"updatedAt": "2020-10-13T17:46:54.000Z"
},
"description": "string",
"createdAt": "2020-10-13T17:46:54.000Z",
"updatedAt": "2020-10-13T17:46:54.000Z"
}
],
"status": "live",
"results": {
"eligibilityStatus": "fail",
"confirmedActivitySubTags": [
{
"id": "activitysubtag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name": "Sport school",
"tag": {
"id": "activitytag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name": "Education",
"description": "string",
"createdAt": "2020-10-13T17:46:54.000Z",
"updatedAt": "2020-10-13T17:46:54.000Z"
},
"description": "string",
"createdAt": "2020-10-13T17:46:54.000Z",
"updatedAt": "2020-10-13T17:46:54.000Z"
}
],
"rejectedActivitySubTags": [
{
"id": "activitysubtag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name": "Sport school",
"tag": {
"id": "activitytag_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name": "Education",
"description": "string",
"createdAt": "2020-10-13T17:46:54.000Z",
"updatedAt": "2020-10-13T17:46:54.000Z"
},
"description": "string",
"createdAt": "2020-10-13T17:46:54.000Z",
"updatedAt": "2020-10-13T17:46:54.000Z"
}
]
},
"createdAt": "2020-10-13T17:46:54.000Z",
"updatedAt": "2020-10-13T17:46:54.000Z"
},
"object": "eligibility_subscription"
}
Bad request
- application/json
- Schema
- Example (from schema)
- InvalidMetadata
Schema
error object
{
"error": {
"code": "string",
"title": "string",
"message": "string",
"reasons": [
"string"
]
}
}
400 Bad request
{
"error": {
"title": "Bad request",
"message": "Metadata can only contain from 1 up to 20 keys, with key names up to 50 characters long and values up to 500 characters long",
"code": "eligibility_subscription/invalid_metadata"
}
}
Unauthorized
Forbidden (scope)
- application/json
- Schema
- Example (from schema)
Schema
error object
{
"error": {
"code": "forbidden",
"title": "Forbidden",
"message": "Access is denied due to missing scope permissions"
}
}
The specified resource was not found
- application/json
- Schema
- Example (from schema)
Schema
error object
{
"error": {
"code": "not_found",
"title": "Resource not found",
"message": "This endpoint is unavailable or can not be found"
}
}