Request artifact access grant

POST

https://api.sureshake.com/v2/entities/{entityId}/vault/fundraising/artifacts/{artifactId}/access-grant

Path parameters

entityId
string
required
format: uuid

artifactId
string
required
format: uuid

Returns

200

Default Response

JSON

data
object
required
- allowed
  boolean
  required
- reason
  string
  required
- tokenNetwork
  base-mainnet
  required
- tokenVerified
  boolean
  required
- expiresAt
  string
  or null
  required
  format: date-time
- artifactId
  string
  required
  format: uuid
- collectionId
  string
  required
  format: uuid
- documentUrl
  string
  or null
  required
  format: uri
- documentUrlExpiresAt
  string
  or null
  required
  format: date-time
}
meta
optional
object
- timestamp
  string
  required
  format: date-time
}

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

409

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

503

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

{ "data": { "allowed": true, "reason": "string", "tokenNetwork": "base-mainnet", "tokenVerified": true, "expiresAt": "2019-08-24T14:15:22Z", "artifactId": "706a3f1e-c357-4634-b1bf-20c221b5bb4e", "collectionId": "0ffe69e2-b7af-4b1e-835c-867376165f50", "documentUrl": "http://example.com", "documentUrlExpiresAt": "2019-08-24T14:15:22Z" }, "meta": { "timestamp": "2019-08-24T14:15:22Z" } }