Update Proof#
Update the external reference of a single Proof owned by your account.
Only external_reference_id can be updated. To replace the document, delete the
Proof and create a new one.
Request#
HTTP Method: PATCH
URI Path: /v3/proofs/{id}
URI Query Parameters#
Name |
Type |
Is Required? |
Description |
|---|---|---|---|
id |
|
Yes |
Unique ID identifier of the Proof. |
Request Body Object Attributes#
Name |
Type |
Is Required? |
Description |
|---|---|---|---|
external_reference_id |
|
No |
Optional identifier for the proof in the customer’s external system. Maximum length is 100 characters. Send |
Examples#
http
1PATCH /v3/proofs/84155378-88d5-456e-844d-103596e3fb2c HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
6
7{
8 "data": {
9 "id": "84155378-88d5-456e-844d-103596e3fb2c",
10 "type": "proofs",
11 "attributes": {
12 "external_reference_id": "test"
13 }
14 }
15}
curl
1curl -i -X PATCH https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --data-raw '{"data": {"attributes": {"external_reference_id": "test"}, "id": "84155378-88d5-456e-844d-103596e3fb2c", "type": "proofs"}}'
response
1HTTP/1.1 200 OK
2Content-Type: application/vnd.api+json
3
4{
5 "data": {
6 "id": "84155378-88d5-456e-844d-103596e3fb2c",
7 "type": "proofs",
8 "attributes": {
9 "created_at": "2021-03-28T18:01:50.387Z",
10 "expires_at": null,
11 "external_reference_id": "test"
12 },
13 "relationships": {
14 "proof_type": {
15 "links": {
16 "self": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/proof_type",
17 "related": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/proof_type"
18 }
19 },
20 "entity": {
21 "links": {
22 "self": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/relationships/entity",
23 "related": "https://api.didww.com/v3/proofs/84155378-88d5-456e-844d-103596e3fb2c/entity"
24 }
25 }
26 }
27 },
28 "meta": {
29 "api_version": "2026-11-19"
30 }
31}
Other Responses#
Code |
Success |
Description |
|---|---|---|
404 |
No |
|
400 |
No |
|
401 |
No |
|
403 |
No |
The access token carries the |
422 |
No |
|
429 |
No |
The request budget of the account for the current window is spent ( |