Applications

An Application represents a logical collection of resources provisioned within Provide's containerized microservices architecture. An application is immutably configured upon initialization with support for a primary Network.
Access to programmatically manage resources associated with an application is provided via REST API, to which ACL-based authorization is managed using generic permissions.
The organizing user of an Application is associated with the application record for historical purposes and does not authorize any access to the application.
Virtual Resources
Applications can programmatically create and associate "virtual" User and Organization records. Use-cases such as KYC and certain multi-tenant applications which implement their own upstream authentication and authorization are good examples of where such virtual resources make sense.
List Applications
Retrieve a list of applications in the authorized scope.
get
https://ident.provide.services
/api/v1/applications
List Applications
curl
Response JSON
1
curl -i \
2
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
3
     https://ident.provide.services/api/v1/applications
4
HTTP/2 200
Copied!
1
{
2
    "id": "efef1044-4958-43bc-903b-28f2bb938037"
3
}
Copied!
Create Application
Create a new application.
post
https://ident.provide.services
/api/v1/applications
Create Application
curl
Response JSON
1
curl -XPOST -i \
2
     -H 'content-type: application/json' \
3
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
4
     https://ident.provide.services/api/v1/applications \
5
     -d '{}'
6
HTTP/2 201
Copied!
1
{
2
    "id": "4059f749-55ad-4c1c-975d-6c5040801079"
3
}
Copied!
Retrieve Application Details
Retrieve details for an application.
get
https://ident.provide.services
/api/v1/applications/:id
Get Application Details
curl
Response JSON
1
curl -i \
2
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
3
     https://ident.provide.services/api/v1/applications/efef1044-4958-43bc-903b-28f2bb938037
4
HTTP/2 200
Copied!
1
{
2
    "id": "efef1044-4958-43bc-903b-28f2bb938037"
3
}
Copied!
URL Parameters
Parameter
Description
id
id of the Application
Update Application
Update an application.
post
https://ident.provide.services
/api/v1/applications
Update Application
curl
1
curl -XPUT -i \
2
     -H 'content-type: application/json' \
3
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
4
     https://ident.provide.services/api/v1/applications/efef1044-4958-43bc-903b-28f2bb938037 \
5
     -d '{}'
6
HTTP/2 204
Copied!
URL Parameters
Parameter
Text
id
id of the Application
Delete Application
Delete an application.
curl
1
curl -XDELETE -i \
2
     -H 'content-type: application/json' \
3
     -H 'authorization: bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJkYXRhIjp7fSwiZXhwIjpudWxsLCJpYXQiOjE1NTk4Nzg1NzQsImp0aSI6IjYzYTJkY2QzLWI5OTgtNDZjNC1hNzFkLTQ5MjU4YTBhYmEyMyIsInN1YiI6ImFwcGxpY2F0aW9uOmNiMjAzN2Y3LTc5ZmMtNDBmNC05NzIwLWFkYTYzNmRhNDE4MyJ9.0LsVj7oTF0KjwbcUhg9a-fQRWB7cGzKJxLIANeX2cWE' \
4
     https://ident.provide.services/api/v1/applications/efef1044-4958-43bc-903b-28f2bb938037 \
5
HTTP/2 204
Copied!
post
https://ident.provide.services
/api/v1/applications/:id/organizations
Associate Application Organization
post
https://ident.provide.services
/api/v1/applications/:id/users
Associate Application User
get
https://ident.provide.services
/api/v1/applications/:id/users
List Application Users