An organization represents the highest level of the API Services BaaS data hierarchy. It contains applications (and the entities and collections they contain) and is associated with one or more administrators. An organization can be representative of a company, team, or project. It allows multiple applications to be shared within the organization with other administrators.
Use the POST method to create an organization through a form post.
POST /organizations|orgs {request body}
Parameters
Expected to be sent form data in the body of the request.
Parameter Description
organization (string) The name of the organization. username (string) The username of the administrator. name (string) The name of the administrator. email (string) The email address of the administrator. password (string) The password of the administrator.
curl -X -i POST "https://api.usergrid.com/management/orgs" -d '{"password":"test12345","email":"tester123@hotmail.com","name":"test","username":"test123","organization":"testorg"}'
{ "action": "new organization", "status": "ok", "data": { "owner": { "applicationId": "00000000-0000-0000-0000-000000000001", "username": "tester123", "name": "test", "email": "tester123@hotmail.com", "activated": false, "disabled": false, "uuid": "48c92c73-0d7e-11e2-98b9-12313d288ee0", "adminUser": true, "displayEmailAddress": "tester123 <tester123@hotmail.com>", "htmldisplayEmailAddress": "tester123 <<a href="mailto:tester123@hotmail.com">tester123@hotmail.com</a>>" }, "organization": { "name": "testorg", "uuid": "5de0bb69-0d7f-11e2-87b9-12313d288ff0" } }, "timestamp": 1349284674173, "duration": 21376 }
Use the GET method to retrieve an organization given a specified UUID or username.
GET /organizations|orgs/{org_name}|{uuid}
Parameters
Parameter Description
org_name|arg uuid Organization name or organization UUID.
Note: You also need to provide a valid access token with the API call. See Authenticating users and application clients for details.
curl -X GET "https://api.usergrid.com/management/orgs/testorg"
{ "timestamp": 1349286861746, "duration": 18, "organization": { "users": { "tester123": { "applicationId": "00000000-0000-0000-0000-000000000001", "username": "tester123", "name": "test", "email": "tester123@hotmail.com", "activated": true, "disabled": false, "uuid": "327b527f-cd0c-11e1-bcf7-12313d1c4491", "adminUser": true, "displayEmailAddress": "tester123 <tester123@hotmail.com>", "htmldisplayEmailAddress": "tester123 <<a href="mailto:tester123@hotmail.com">tester123@hotmail.com</a>>" } }, "name": "testorg", "applications": { "tester123/sandbox": "3400ba10-cd0c-11e1-bcf7-12313d1c4491", "tester123/testapp1": "be08a5f9-fdd3-11e1-beca-12313d027471", "tester123/testapp2": "cede5b7e-fe90-11e1-95c8-12313b122c56" }, "uuid": "33dd0563-cd0c-11e1-bcf7-12313d1c4491" }
Use the GET method to activate an organization from a link provided in an email notification.
GET /organizations|orgs/{org_name}|{uuid}/activate?token={token}&confirm={confirm_email}
Parameters
Parameter Description
org_name|arg uuid Organization name or organization UUID. token Activation token (supplied via email). confirm_email (boolean) Send confirmation email (false is the default).
curl -X GET "https://api.usergrid.com/management/orgs/testorg/activate?token=33dd0563-cd0c-11e1-bcf7-12313d1c4491"
{ "action": "activate organization", "timestamp": 1337928462810, "duration": 3342 }
Use the GET method to reactivate an organization.
GET /organizations|orgs/{org_name}|{uuid}/reactivate
Parameters
Parameter Description
string org_name|arg uuid Organization name or organization UUID.
curl -X GET "https://api.usergrid.com/management/orgs/testorg/reactivate"
{ "action": "reactivate organization", "timestamp": 1349385280891, "duration": 3612 }
Use the POST method to generate new credentials for an organization client.
POST /organizations|orgs/{org_name}|{uuid}/credentials
Parameters
Parameter Description
string org_name|arg uuid Organization name or organization UUID.
Note: You also need to provide a valid access token with the API call. Authenticating users and application clients for details.
curl -X POST "https://api.usergrid.com/management/orgs/credentials"
{ "action": "generate organization client credentials", "timestamp": 1349385795647, "duration": 7, "credentials": { "client_id": "c2V7N61DY90MCdG78xIxPRxFdQ", "client_secret": "c2V7WEdXIutZWEkWdySLCt_lYDFVMMN" } }
Use the GET method to retrieve the credentials for an organization client.
GET /organizations|orgs/{org_name}|{uuid}/credentials
Parameters
Parameter Description
string org_name|arg uuid Organization name or organization UUID.
Note: You also need to provide a valid access token with the API call. See Authenticating users and application clients for details.
curl -X GET "https://api.usergrid.com/management/orgs/testorg/credentials"
{ "action": "get organization client credentials", "timestamp": 1349386672984, "duration": 690, "credentials": { "client_id": "c2V7N61DY90MCdG78xIxPRxFdQ", "client_secret": "c2V7WEdXIutZWEkWdySLCt_lYDFVMMN" } }
Use the GET method to get an organization's activity feed.
GET /organizations|orgs/{org_name}|{uuid}/feed
Parameters
Parameter Description
string org_name|arg uuid Organization name or organization UUID.
Note: You also need to provide a valid access token with the API call. See Authenticating users and application clients for details.
curl -X GET "https://api.usergrid.com/management/orgs/testorg/feed"
{ { "action": "get organization feed", "status": "ok", "entities": [ { "uuid": "cf4d981c-fe90-11e1-95c8-12313b122c56", "type": "activity", "created": 1347643370454, "modified": 1347643370454, "actor": { "displayName": "tester123", "objectType": "person", "uuid": "327b527f-cd0c-11e1-bcf7-12313d1c4491", "entityType": "user" }, "category": "admin", "metadata": { "cursor": "gGkAAQMAgGkABgE5xc3r1gCAdQAQz02YHP6QEeGVyBIxOxIsVgCAdQAQz3SoH_6QEeGVyBIxOxIsVgA", "path": "/groups/33dd0563-cd0c-11e1-bcf7-12313d1c4491/feed/cf4d981c-fe90-11e1-95c8-12313b122c56" }, "object": { "displayName": "testapp2", "objectType": "Application", "uuid": "cede5b7e-fe90-11e1-95c8-12313b122c56", "entityType": "application_info" }, "published": 1347643370454, "title": "<a mailto="mailto:tester123@hotmail.com">tester123 (tester123@hotmail.com)</a> created a new application named testapp2", "verb": "create" },... , "timestamp": 1349387253811 }
Use the GET method to retrieve the applications in an organization.
GET /organizations|orgs/{org_name}|{uuid}/applications|apps
Parameters
Parameter Description
string org_name|arg uuid Organization name or organization UUID.
Note: You also need to provide a valid access token with the API call. See Authenticating users and application clients for details.
curl -X GET "https://api.usergrid.com/management/orgs/testorg/apps"
{ "action": "get organization application", "data": { "testorg/sandbox": "3500ba10-cd0c-11e1-bcf8-12313d1c5591", "testorg/testapp1": "be09a5f9-fdd3-11e1-beca-12313d027361", "testorg/testapp2": "cede5b8e-fe90-11e1-65c8-12313b111c56" }, "timestamp": 1349815338635, "duration": 22 }
Use the PUT method to add an existing admin user to an organization.
PUT /organizations|orgs/{org_name}|{org_uuid}/users/{username|email|uuid}
Parameters
Parameter Description
string org_name|arg org_uuid Organization name or organization UUID. string username|string email|arg uuid User name, user email address, or user UUID.
curl -X PUT "https://api.usergrid.com/management/orgs/testorg/users/test123"
{ "action": "add user to organization", "status": "ok", "data": { "user": { "applicationId": "00000000-0000-0000-0000-000000000001", "username": "tester123", "name": "test", "email": "tester123@hotmail.com", "activated": true, "disabled": false, "uuid": "335b527f-cd0d-11e1-bef8-12331d1c5591", "adminUser": true, "displayEmailAddress": "tester123 <tester123@hotmail.com>", "htmldisplayEmailAddress": "tester123 <<a href="mailto:tester123@hotmail.com">tester123@hotmail.com</a>>" } }, "timestamp": 1349390189106, "duration": 11808 }
Use the GET method to retrieve details about the admin users in an organization.
GET /organizations|orgs/{org_name}|{org_uuid}/users
Parameters
Parameter Description
org_name|arg org_uuid Organization name or organization UUID.
curl -X GET "https://api.usergrid.com/management/orgs/testorg/users"
{ "action": "get organization users", "data": { "user": { "applicationId": "00000000-0000-0000-0000-000000000001", "username": "tester123", "name": "test", "email": "tester123@hotmail.com", "activated": true, "disabled": false, "uuid": "335b527f-cd0d-11e1-bef8-12331d1c5591", "adminUser": true, "displayEmailAddress": "tester123 <tester123@hotmail.com>", "htmldisplayEmailAddress": "tester123 <<a href="mailto:tester123@hotmail.com">tester123@hotmail.com</a>>" } }, "timestamp": 13494542201685, "duration": 10 }
Use the DELETE method to remove an admin user from an organization. All organizations must have a minimum of one user with org admin privileges. If you attempt to delete the last org admin in an organization, the API will return a 400 Bad Request error.
DELETE /organizations|orgs/{org_name}|{org_uuid}/users/{username|email|uuid}
Parameters
Parameter Description
org_name|arg org_uuid Organization name or organization UUID. username|string email|arg uuid User name, user email address, or user UUID.
curl -X DELETE "https://api.usergrid.com/management/orgs/testorg/users/test123"
{ "action": "remove user from organization", "status": "ok", "data": { "user": { "applicationId": "00000000-0000-0000-0000-000000000001", "username": "tester123", "name": "test", "email": "tester123@hotmail.com", "activated": true, "disabled": false, "uuid": "335b527f-cd0d-11e1-bef8-12331d1c5591", "adminUser": true, "displayEmailAddress": "tester123 <tester123@hotmail.com>", "htmldisplayEmailAddress": "tester123 <<a href="mailto:tester123@hotmail.com">tester123@hotmail.com</a>>" } }, "timestamp": 1349453590005, "duration": 727 }