Instance Organizations Actions
https://api.losant.com/instances/INSTANCE_ID
/orgs
Below are the various requests that can be performed against the Instance Organizations resource, as well as the expected parameters and the potential responses.
Get
Returns the organizations associated with the current instance
Method And Url
GET https://api.losant.com/instances/INSTANCE_ID
/orgs
Authentication
A valid API access token is required to access this endpoint. The token must
include at least one of the following scopes:
all.Instance
, all.Instance.read
, all.User
, all.User.read
, instanceOrgs.*
, or instanceOrgs.get
.
Request Path Components
Path Component | Description | Example |
---|---|---|
INSTANCE_ID | ID associated with the instance | 575ec8687ae143cd83dc4a97 |
Request Query Parameters
Name | Required | Description | Default | Example |
---|---|---|---|---|
sortField | N | Field to sort the results by. Accepted values are: name, id, creationDate, lastUpdated | name | sortField=name |
sortDirection | N | Direction to sort the results by. Accepted values are: asc, desc | asc | sortDirection=asc |
page | N | Which page of results to return | 0 | page=0 |
perPage | N | How many items to return per page | 100 | perPage=10 |
filterField | N | Field to filter the results by. Blank or not provided means no filtering. Accepted values are: name | filterField=name | |
filter | N | Filter to apply against the filtered field. Supports globbing. Blank or not provided means no filtering. | filter=my*org | |
summaryInclude | N | Comma-separated list of summary fields to include in org summary | summaryInclude=payloadCount | |
query | N | Organization filter JSON object which overrides all other filter params. See Advanced Instance Organization Query for more details. | query={"name":"Bob's Org","lastUpdated":"2022-01-30T17:18:11.911Z"} |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X GET \
https://api.losant.com/instances/INSTANCE_ID/orgs
Successful Responses
Code | Type | Description |
---|---|---|
200 | Instance Organizations | A collection of organizations |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
Post
Create a new organization
Method And Url
POST https://api.losant.com/instances/INSTANCE_ID
/orgs
Authentication
A valid API access token is required to access this endpoint. The token must
include at least one of the following scopes:
all.Instance
, all.User
, instanceOrgs.*
, or instanceOrgs.post
.
Request Path Components
Path Component | Description | Example |
---|---|---|
INSTANCE_ID | ID associated with the instance | 575ec8687ae143cd83dc4a97 |
Request Query Parameters
Name | Required | Description | Default | Example |
---|---|---|---|---|
summaryInclude | N | Comma-separated list of summary fields to include in org summary | summaryInclude=payloadCount |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Request Body
The body of the request should be serialized JSON that validates against the Instance Owned Organization Post schema. For example, the following would be a valid body for this request:
{
"name": "My Org",
"limits": {
"member": 500
},
"auditLogEnabled": true
}
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X POST \
https://api.losant.com/instances/INSTANCE_ID/orgs
Successful Responses
Code | Type | Description |
---|---|---|
200 | Organization | The newly created organization |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
Schemas
Advanced Instance Organization Query
Schema for advanced instance organization queries
Advanced Instance Organization Query Schema
- ▶{} 4 keys
- "http://json-schema.org/draft-07/schema#"
- "object"
- ▶{} 14 keys
- ▶{} 3 keys
- ▶{} 3 keys
- ▶{} 3 keys
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- false
Advanced Instance Organization Query Example
- ▶{} 2 keys
- "Bob's Org"
- "2022-01-30T17:18:11.911Z"
Error
Schema for errors returned by the API
Error Schema
- ▶{} 3 keys
- "http://json-schema.org/draft-07/schema#"
- "object"
- ▶{} 2 keys
- ▶{} 1 key
- ▶{} 1 key
Error Example
- ▶{} 2 keys
- "NotFound"
- "Application was not found"
Instance Owned Organization Post
Schema for the body of an Organization creation request within an instance
Instance Owned Organization Post Schema
- ▶{} 5 keys
- "http://json-schema.org/draft-07/schema#"
- "object"
- ▶{} 13 keys
- ▶{} 3 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 3 keys
- ▶{} 3 keys
- ▶{} 2 keys
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 3 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 3 keys
- false
- ▶[] 1 item
Instance Owned Organization Post Example
- ▶{} 3 keys
- "My Org"
- ▶{} 1 key
- true
Instance Organizations
Schema for a collection of Organizations within an instance
Instance Organizations Schema
- ▶{} 3 keys
- "http://json-schema.org/draft-07/schema#"
- "object"
- ▶{} 10 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 2 keys
Instance Organizations Example
- ▶{} 7 keys
- ▶[] 1 item
- 1
- 2
- 1
- 0
- "name"
- "asc"
Organization
Schema for a single Organization
Organization Schema
- ▶{} 3 keys
- "http://json-schema.org/draft-07/schema#"
- "object"
- ▶{} 21 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 3 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 3 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 3 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 1 key
- ▶{} 2 keys
- ▶{} 2 keys
- ▶{} 1 key
- ▶{} 1 key
- ▶{} 2 keys
- ▶{} 3 keys
Organization Example
- ▶{} 8 keys
- "575ed6e87ae143cd83dc4aa8"
- "575ed6e87ae143cd83dc4aa8"
- "2016-06-13T04:00:00.000Z"
- "2016-06-13T04:00:00.000Z"
- "My Organization"
- "My organization description"
- ▶[] 2 items
- ▶{} 7 keys
Was this page helpful?
Still looking for help? You can also search the Losant Forums or submit your question there.