Backpack

Get Assertion Collection(s) associated with the authenticated user's backpack

get
Required scopes
This endpoint requires the following scopes:
  • : List assertions in your backpack
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Path parameters
idOrEntityIdstringRequired
Responses
200

OK

*/*
get
/v2/backpack/collections/{idOrEntityId}

Update a Collection

put
Required scopes
This endpoint requires the following scopes:
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Path parameters
idOrEntityIdstringRequired
Body
namestringOptional

Name of the collection

Example: My Collection
descriptionstringOptional

Short description of the Collection

Example: This is a collection of my favorite badges
publishedbooleanOptional

True if the Collection should have a share url

Example: true
assertionsstring[]Optional

The IDs or entity IDs of the assertions associated with this Collection

Example: UQbhRmNrQ4qn9_FJ5-eTtA
credentialsstring[]Optional

The IDs or entity IDs of the credentials associated with this Collection

Example: UQbhRmNrQ4qn9_FJ5-eTtA
Responses
200

OK

*/*
put
/v2/backpack/collections/{idOrEntityId}

Delete a collection

delete
Required scopes
This endpoint requires the following scopes:
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Path parameters
idOrEntityIdstringRequired
Responses
delete
/v2/backpack/collections/{idOrEntityId}

No content

Get detail on an Assertion in the user's Backpack

get
Required scopes
This endpoint requires the following scopes:
  • : List assertions in your backpack
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Path parameters
idOrEntityIdstringRequired
Query parameters
Responses
200

OK

*/*
get
/v2/backpack/assertions/{idOrEntityId}

Update acceptance of an Assertion in the user's Backpack

put
Required scopes
This endpoint requires the following scopes:
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Path parameters
idOrEntityIdstringRequired
Responses
200

OK

*/*
put
/v2/backpack/assertions/{idOrEntityId}

Remove an assertion from the backpack

delete
Required scopes
This endpoint requires the following scopes:
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Path parameters
idOrEntityIdstringRequired
Responses
delete
/v2/backpack/assertions/{idOrEntityId}

No content

Upload a new Assertion to the backpack

post

Upload a new Assertion to the backpack using url, image or OpenBadge JSON

Required scopes
This endpoint requires the following scopes:
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Body
urlstring · uriOptional

URL of the badge to import

Example: https://example.com/assertions/1
assertionobjectOptional

OpenBadge JSON of the award to import

imagestringOptional

Image URL or base64 encoded image data of the assertion.

Example: https://example.com/assertions/1/image
Responses
post
/v2/backpack/import

Get Assertion Collection(s) associated with the authenticated user's backpack

get
Required scopes
This endpoint requires the following scopes:
  • : List assertions in your backpack
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Responses
200

OK

*/*
get
/v2/backpack/collections

Create a new Collection

post
Required scopes
This endpoint requires the following scopes:
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Body
namestringRequired

Name of the collection

Example: My Collection
descriptionstringOptional

Short description of the Collection

Example: This is a collection of my favorite badges
publishedbooleanRequired

True if the Collection should have a share url

Example: true
Responses
post
/v2/backpack/collections

Get a list of Assertions in authenticated user's backpack

get
Required scopes
This endpoint requires the following scopes:
  • : List assertions in your backpack
  • : Upload badges to your backpack
Authorizations
OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:
Query parameters
Responses
200

OK

*/*
get
/v2/backpack/assertions

Last updated

Was this helpful?