Current section
Files
Jump to
Current section
Files
lib/slack/web/docs/files.completeUploadExternal.json
{
"args": {
"blocks": {
"desc": "A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the `initial_comment` field is provided, the `blocks` field is ignored",
"example": "[{\"type\": \"section\", \"text\": {\"type\": \"plain_text\", \"text\": \"Hello world\"}}]",
"required": false,
"type": "string"
},
"channel_id": {
"desc": "Channel ID where the file will be shared. If not specified the file will be private.",
"example": "C0NF841BK",
"required": false
},
"channels": {
"desc": "Comma-separated string of channel IDs or user IDs where the file will be shared.",
"example": "C0NF841BK,C2AW648GH",
"required": false,
"type": "string"
},
"files": {
"desc": "Array of file ids and their corresponding (optional) titles.",
"example": "[{\"id\":\"F044GKUHN9Z\", \"title\":\"slack-test\", \"highlight_type\":\"png\"}]",
"required": true,
"type": "array"
},
"initial_comment": {
"desc": "The message text introducing the file in specified channels.",
"required": false,
"type": "string"
},
"thread_ts": {
"desc": "Provide another message's `ts` value to upload this file as a reply. Never use a reply's `ts` value; use its parent instead. Also make sure to provide only one channel when using 'thread\\_ts'",
"example": "1524523204.000192",
"required": false,
"type": "string"
}
},
"desc": "Finishes an upload started with files.getUploadURLExternal",
"errors": {
"access_denied": "User is not the owner of the file.",
"accesslimited": "Access to this method is limited on the current network",
"account_inactive": "Authentication token is for a deleted user or workspace when using a `bot` token.",
"channel_not_found": "Value passed for `channel_id` was invalid.",
"channels_limit_exceeded": "Exceeded the channel limit. A maximum of 100 channels is allowed per request.",
"deprecated_endpoint": "The endpoint has been deprecated.",
"ekm_access_denied": "Administrators have suspended the ability to post a message.",
"enterprise_is_restricted": "The method cannot be called from an Enterprise.",
"fatal_error": "The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.",
"file_not_found": "Could not find the file from the upload ticket.",
"file_type_not_allowed": "The file type is not permitted based on the team's allowed\\_file\\_upload\\_types preference.",
"file_update_failed": "Failure occurred when attempting to update the file.",
"file_uploads_except_images_disabled": "Only image file uploads are permitted for this team.",
"internal_error": "The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.",
"invalid_arg_name": "The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than `_`. If you get this error, it is typically an indication that you have made a _very_ malformed API call.",
"invalid_arguments": "The method was called with invalid arguments.",
"invalid_array_arg": "The method was passed an array as an argument. Please only input valid strings.",
"invalid_auth": "Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.",
"invalid_blocks": "Provided blocks are in the incorrect format.",
"invalid_channel": "Channel could not be found or channel specified is invalid.",
"invalid_charset": "The method was called via a `POST` request, but the `charset` specified in the `Content-Type` header was invalid. Valid charset names are: `utf-8` `iso-8859-1`.",
"invalid_form_data": "The method was called via a `POST` request with `Content-Type` `application/x-www-form-urlencoded` or `multipart/form-data`, but the form data was either missing or syntactically invalid.",
"invalid_post_type": "The method was called via a `POST` request, but the specified `Content-Type` was invalid. Valid types are: `application/json` `application/x-www-form-urlencoded` `multipart/form-data` `text/plain`.",
"method_deprecated": "The method has been deprecated.",
"missing_post_type": "The method was called via a `POST` request and included a data payload, but the request did not include a `Content-Type` header.",
"missing_scope": "The token used is not granted the specific scope permissions required to complete this request.",
"no_permission": "The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.",
"not_allowed_token_type": "The token type used in this request is not allowed.",
"not_authed": "No authentication token provided.",
"not_in_channel": "User/bot membership is required for the specified channel.",
"org_login_required": "The workspace is undergoing an enterprise migration and will not be available until migration is complete.",
"posting_to_channel_denied": "User is not authorized to post to channel.",
"ratelimited": "The request has been ratelimited. Refer to the `Retry-After` header for when to retry the request.",
"request_timeout": "The method was called via a `POST` request, but the `POST` data was either missing or truncated.",
"service_unavailable": "The service is temporarily unavailable",
"team_access_not_granted": "The token used is not granted the specific workspace access required to complete this request.",
"team_added_to_org": "The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.",
"token_expired": "Authentication token has expired",
"token_revoked": "Authentication token is for a deleted user or workspace or the app has been removed when using a `user` token.",
"two_factor_setup_required": "Two factor setup is required."
}
}