Edit an Agent Verification
PATCH/v1/agent-verifications/:id
Update an Agent Verifications metadata.
Request​
Path Parameters
Id of the Agent Verification.
- 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
Successfully update Agent Verification metadata
- application/json
- Schema
- Example (from schema)
Schema
data
object
agentverification_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Max
Plank
Organisation Id
organisation_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
organisation
object
Organisation Id
organisation_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Organisation email
org@example.com
Organisation name
Great Charity
example@example.com
en-GB
validationrequest_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
validationRequest
object
Great Charity
Board Member
Reason for rejecting agent verification
Possible values: [Validation request failed
, User verification expired
, Identity check failed
, No evidence agent’s email is associated with organisation
, Agent/nonprofit will reapply
, Agent used fake or test email
, No online presence to complete check
, Nonprofit association expired
, Other
]
Reason code for rejecting agent verification
Possible values: [validation_request_failed
, user_verification_expired
, user_failed_percent_review
, reapply
, fake_email_used
, no_online_presence
, nonprofit_association_expired
, invalid_documentation
, fake_documentation
, mismatched_information
, blank_corrupted_documentation
, suspicious_application
, other
]
2020-10-13T17:46:54.000Z
Possible values: [pending
, pending_user_verification
, pending_review
, approved
, rejected
]
pending
true
agent_verification
{
"data": {
"id": "agentverification_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"firstName": "Max",
"lastName": "Plank",
"organisationId": "organisation_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"organisation": {
"id": "organisation_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"email": "org@example.com",
"name": "Great Charity"
},
"email": "example@example.com",
"language": "en-GB",
"validationRequestId": "validationrequest_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"validationRequest": {
"name": "Great Charity"
},
"title": "Board Member",
"rejectionReasonCode": "validation_request_failed",
"createdAt": "2020-10-13T17:46:54.000Z",
"status": "pending",
"externalActionRequired": true
},
"object": "agent_verification"
}
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": "agent_verification/invalid_metadata"
}
}
Unauthorized
Forbidden (scope)
- application/json
- Schema
- Example (from schema)
Schema
error
object
forbidden
Forbidden
Access is denied due to missing scope permissions
{
"error": {
"code": "forbidden",
"title": "Forbidden",
"message": "Access is denied due to missing scope permissions"
}
}