Apps

What a page is

A Teammate can build a small web page (a job board, an intake form, a calculator) and publish it to its own address, https://<page>--<company>.associatesai.page/. The <company> part is your team's short name, chosen for you from your team name, for example https://job-board--acme-plumbing.associatesai.page/. It is set the first time a page is published and does not change if you later rename your company. To change it, contact support. You ask the Teammate to build and publish it; the Apps page in your dashboard then lists it.

A page name uses lowercase letters, digits and single hyphens, is 3 to 32 characters, is not only digits, and starts and ends with a letter or digit. A name only has to be unique within your team, so another team can use the same name at its own address. A few names such as www, api, admin and docs are reserved.

Publishing a page you already have

To publish a site you built elsewhere, or a page around a data file you have, zip the folder and attach the zip in a chat with your Teammate (dashboard chat, Telegram, Slack or Discord), then ask it to publish it under a name. In dashboard chat, large uploads take files of any type up to 32 MB, and the file goes straight to your Teammate's server without passing through the model. Your Teammate unpacks the zip on its server and publishes it from there, so the limits below apply to what is inside. It refuses a folder that contains a link (symlink) or a secret placeholder, and tells you which file to fix.

Who can open a page

Only members of your team. Opening the address sends the visitor to sign in with their dashboard login, and then back to the page. Any team they belong to counts, not just the one currently selected. Someone who is signed in but is not on the team sees a "You are not on this team" page. A sign-in lasts 8 hours.

Saved data

A page can save text that is shared with the whole team, or text private to the signed-in person. Each saved value can be up to 64 KB. A page can show who is signed in by name (or email if there is no name).

Asking a Teammate from a page

Publishing never connects a Teammate to a page by itself. When a Teammate asks for access, the Apps page shows "Waiting for approval" next to the Teammate's name. Until it is approved, the page's questions to the Teammate fail with "waiting for approval in the dashboard".

• A team owner or admin selects Approve on that row. The approval is for the Teammate and server shown there. If the page is republished with a different Teammate or from a different server before you approve, you are asked to reload and review the request again.
• Revoke agent takes the access back at once.
• Republishing with the same Teammate on the same server keeps the approval. A different Teammate or server needs a new one.
• Other team members see the state but do not get the buttons.

Each question starts a fresh conversation, so the Teammate has no memory of earlier questions from the page. Questions use your own agent server and are billed as normal model usage. Approval covers connecting the Teammate, not the page's content: anyone on the team using an approved page can send that Teammate messages, so approve pages you trust.

Managing pages in the dashboard

Open Dashboard > Apps. Each page shows its link, a "Team only" badge, the server it was published from, the Teammate and its approval state, and its versions with the date and number of files. Every publish adds a version.

• Roll back to this version makes an older version the live page.
• Unpublish takes the page down. Its saved data is kept, and so are its versions.
• An unpublished page shows an "Unpublished" badge, and its versions offer Publish this version instead. Choosing one brings the page back at that version.

Asking a Teammate to roll back or unpublish

A Teammate can do the same two things when you ask in chat: put an older version back live, or take a page down. It sees the page's name and versions with their dates, and it only reaches your own team's pages. Rolling back a page that is unpublished brings it back, and the page limit below still applies. On the Apps page, the Live marker moves to the restored version, and an unpublished page shows "Unpublished". Servers created before this feature can roll back or unpublish through their Teammate after the server's next refresh from the dashboard; until then, use the Apps page.

Approving or revoking a Teammate's access to a page is never something a Teammate can do. It stays in the dashboard, for team owners and admins.

Limits

• Up to 150 published pages per team. Unpublished pages do not count. Publishing a new page, or bringing an unpublished one back, is refused at the limit with a message to unpublish one first.
• A zip of up to 10 MB, up to 200 files, and up to 25 MB once unzipped.
• The zip must have an index.html at its top level, not inside a folder.
• File names use only letters, digits and the characters ., _, - and /, up to 200 characters, with no ... Rename files that have spaces, accents or other characters before zipping, and replace links (symlinks) with the real file.
• Two files with the same name in one zip are refused.

Troubleshooting

• "waiting for approval in the dashboard": approve the Teammate on Dashboard > Apps.
• "app name ... is taken": the name was claimed in your team a moment earlier; pick another.
• "Your team has reached the limit of 150 published apps": unpublish a page you no longer need.
• "Page names use lowercase letters, digits and single hyphens...": rename the page to 3 to 32 characters, not only digits, with no double hyphen.
• "Bad file path ...": rename the file as described under Limits.
• "The zip needs an index.html at its top level": zip the folder's contents, not the folder itself.