Organization
Represents the Organization itself
All Organization properties requiring Public access are exposed through GET to the public.
Organization Object Data Model
name
data type
description
id
String
The org identifier
access
Number
The current caller’s context access level.
apps
Document
The Org’s configured applications.
code
String
The Org’s code, used to access the api, uniquely identifies the org.
configuration
String
Org configuration settings.
connections
Reference
Connections associated with the Org.
created
Date
The date the context was created
deployment
Document
Org deployment settings
favicon
File
Organization Icon
locale
String
The Org’s default locale setting.
logo
File
The Org logo.
maintenance
Boolean
True if Org is in maintenance mode.
maintenanceMessage
String
The message to show during maintenance mode.
name
String
The Org label.
object
String
The context’s object name.
posts
Reference
A list of posts made in the context of the org.
registration
Document
Org registration settings.
roles
Document
Org’s configured roles
schemasETag
String
Org schemas ETag
security
Document
Org security settings
shared
Boolean
True if there are any active or pending connections for this context.
state
String
The Org state.
support
Document
Support options.
tz
String
Default timezone for the org. This helps determine UTC offset when working in scripts when a user tz is not available. The timezone must by a unique identifier for an IANA assigned zone, e.g. "US/Pacific"
updated
Date
The date the latest update was made to a context’s properties
updater
Reference
The account id of the context updater
website
String
The Org website, available for use as a variable in email templates (org.website).
Example Organization Object
Read (Public)
GET
https://api.dev.medable.com/{your_org_name}/v2
Path Parameters
your_org_name
string
{org_name}
--
Read (Full)
GET
https://api.dev.medable.com/{your_org_name}/v2/orgs/org_id
Path Parameters
your_org_name
string
{org_name}
org_id
string
{org_id}
Update
PUT
https://api.dev.medable.com/{your_org_name}/v2
The Organization settings can only be updated by an Administrator. Because the Org is public, it is possible to add a custom property to allow those with other roles (or no roles) to update it. To demonstrate, the following property has been added to the Organization in the example request to the right, and all Providers given access to push elements onto the c_4providers array.
Path Parameters
your_org_name
string
{org_name}
org_id
string
{org_id}
Update
PATCH
https://api.dev.medable.com/{your_org_name}/v2
Path Parameters
your_org_name
string
{org_name}
org_id
string
{org_id}
Request Body
op
string
op
path
string
path
value
string
value
Last updated