FAQ for agents

Short answers to the questions an agent asks while working through Dropslate. Each answer starts with the direct answer, then the reason. The rules themselves are in Safety rules; the tools in the Tools reference.

Can I create a post without the user’s confirmation?

No. dropslate_create_post and POST /posts refuse without confirm: true (confirm_required) and create nothing. Show the table from dropslate_plan_post first, wait for the person’s yes, then call create with confirm: true.

Where do I get an account id?

From dropslate_list_accounts (or GET /accounts). Never from memory or a guess: an id that does not belong to this workspace answers not_found, and an id you invent does not exist. The list also shows each account’s token state; an expired or revoked account cannot be published to until a person reconnects it.

How do I send a file from the user’s computer?

Call dropslate_create_upload with filename, mime and size, then PUT the bytes to the returned uploadUrl from the local shell - curl -X PUT "<uploadUrl>" -H "Content-Type: video/mp4" --data-binary @file.mp4 - and poll dropslate_get_media until status is ready. The URL is single-use and lives one hour; the Content-Length must equal size. Use the same mediaId for every post that needs the file; never upload it twice.

The file is at a URL, not on a computer.

Use dropslate_upload_from_url (or POST /media/from-url) with a public https URL. Private, internal and non-https addresses are refused. Then poll dropslate_get_media to ready as above.

Is the plan a real action?

No. dropslate_plan_post (POST /posts/plan) has no side effects. Call it as often as needed while working out the plan; it returns one row per account with a check and a text table you can show as is.

What can I do on the Free plan?

Read only. tools/list shows the 11 read tools: whoami, list accounts, groups, media and folders, get media, plan, list and get posts, and the two analytics reads. Publishing needs a paid plan; tell the person so rather than trying a hidden tool - the protocol refuses it.

My key is read-only.

Same as Free: the 11 read tools. A key with write is created in the app under Settings → API keys; you cannot create keys, and you should not ask the person to paste one into the chat - it belongs in the client’s environment.

How should I report the result?

Only after the tool returned success, and with the post id, the account and the absolute time in the workspace’s time zone. The tool’s statusLine is that sentence: Queued. YouTube · What We Made · 28 Sep, 18:00 (Kyiv). dropslate_whoami gives the time zone.

What is when?

"now", "draft", or an object {"publishAt": "2026-09-29T18:00", "timezone": "Europe/Kiev"} - a local time and the IANA zone it is written in - at least 2 minutes ahead and at most a year out. dropslate_whoami gives the workspace’s zone; use it unless the person named another.

The same text does not fit every network.

Put the network’s own text in overrides - {"overrides": {"threads": {"text": "…"}}} - and network-specific settings in perPlatform (youtube.visibility, instagram.contentType, facebook.link, threads.topicTag). The plan checks each account against its own network’s limits and names the field that fails.

A post failed. Should I retry?

Read dropslate_get_post first: error.message is the network’s own words. A token or permission message needs a person to reconnect the account; a limit or quota message retries on its own or later; a file or field message needs a changed post - retrying the same request fails the same way. dropslate_retry_post needs confirm: true.

Can I connect an account, change billing or remove a member?

No. There is no tool for any of those, at any scope. They exist only in the dashboard behind a signed-in session.

Where are the rules I should follow?

In every tool’s description, verbatim, and on Safety rules. A ready skill file with the same rules is at skill.md.