action box_get_collaborations_id { label: "Get collaboration" description: "Retrieves a single collaboration." provider: box method: GET path: "/collaborations/{collaboration_id}" encoding: json input: { type: "object" properties: { collaboration_id: { type: "string" } fields: { type: "array" items: { type: "string" } } } required: ["collaboration_id"] additionalProperties: false } output: { type: "object" description: "Collaborations define access permissions for users and groups to files and\nfolders, similar to access control lists. A collaboration object grants a\nuser or group access to a file or folder with permissions defined by a\nspecific role." properties: { acceptance_requirements_status: { type: "object" properties: { strong_password_requirement: { type: "object" properties: { enterprise_has_strong_password_required_for_external_users: { type: "boolean" description: "Whether or not the enterprise that owns the content requires\na strong password to collaborate on the content." } user_has_strong_password: { type: "boolean" description: "Whether or not the user has a strong password set for their\naccount. The field is `null` when a strong password is not\nrequired." } } } terms_of_service_requirement: { type: "object" properties: { is_accepted: { type: "boolean" description: "Whether or not the terms of service have been accepted. The\nfield is `null` when there is no terms of service required." } terms_of_service: { type: "object" } } } two_factor_authentication_requirement: { type: "object" properties: { enterprise_has_two_factor_auth_enabled: { type: "boolean" description: "Whether or not the enterprise that owns the content requires\ntwo-factor authentication to be enabled in order to\ncollaborate on the content." } user_has_two_factor_authentication_enabled: { type: "boolean" description: "Whether or not the user has two-factor authentication\nenabled. The field is `null` when two-factor\nauthentication is not required." } } } } } accessible_by: { type: "object" } acknowledged_at: { type: "string" format: "date-time" description: "When the `status` of the collaboration object changed to\n`accepted` or `rejected`" } created_at: { type: "string" format: "date-time" description: "When the collaboration object was created" } created_by: { type: "object" } expires_at: { type: "string" format: "date-time" description: "When the collaboration will expire, or `null` if no expiration\ndate is set." } id: { type: "string" description: "The unique identifier for this collaboration." } invite_email: { type: "string" description: "The email address used to invite an unregistered collaborator, if\nthey are not a registered user." } item: { type: "object" } modified_at: { type: "string" format: "date-time" description: "When the collaboration object was last modified" } role: { type: "string" description: "The level of access granted." enum: ["editor", "viewer", "previewer", "uploader", "previewer uploader", "viewer uploader", "co-owner", "owner"] } status: { type: "string" description: "The status of the collaboration invitation." enum: ["accepted", "pending", "rejected"] } type: { type: "string" description: "`collaboration`" enum: ["collaboration"] } } } }