Story Agent — Activation code expired
You generated an activation code (APRT-XXXX-XXXX) from the aprity managed app's Connectors tab to link a tracker (Jira Cloud, Azure DevOps, Slack), and either :
- You did not paste it into the tracker within 30 minutes, or
- The tracker panel reports "code expired" even though the code looks recent.
Why this happens
Activation codes for tracker integrations are short-lived by design :
- Validity window : 30 minutes from the moment you click Generate.
- Single use : once redeemed on the tracker side, the code is invalidated. You cannot redeem the same code twice (this is what prevents code leaks from authorizing two different trackers).
- Tenant-scoped : the code authorizes a specific aprity tenant. Codes generated on one tenant cannot be redeemed on another.
If you generated the code in advance ("for tomorrow's setup session"), or copied it into a chat / email that delayed the paste, the 30-minute window may have elapsed.
Fix
Generate a fresh code -- there is no concept of extending an existing code.
Jira Cloud
- Open Salesforce and navigate to the aprity app.
- Go to the Connectors tab.
- Locate the Jira Cloud card and click Generate New Code.
- A fresh code appears in the format
APRT-XXXX-XXXX. Use it within 30 minutes. - Continue with Jira Cloud — Story Agent setup from Step 3 (paste the code into Aprity Configuration).
Azure DevOps
- Open Salesforce and navigate to the aprity app.
- Go to the Connectors tab.
- Locate the Azure DevOps card and click Generate New Code.
- A fresh code appears in the format
APRT-XXXX-XXXX. Use it within 30 minutes. - Continue with Azure DevOps — Story Agent setup from the Paste the activation code step.
Slack
- Open Salesforce and navigate to the aprity app.
- Go to the Connectors tab.
- Locate the Slack card and click Generate New Code.
- A fresh code appears in the format
APRT-XXXX-XXXX. Use it within 30 minutes. - Continue with Slack — Story Agent setup from the Paste the activation code step.
Best practices to avoid expiry
- Generate the code right before you paste it. Don't generate ahead of time and store it in a doc or chat.
- Have the tracker side ready first. Install the Forge app / Marketplace extension / Slack app, navigate to the Aprity Configuration page, and confirm the paste field is visible -- then come back to aprity and generate the code.
- Use a separate browser tab for Salesforce and the tracker, so you can paste with one keystroke.
- Codes are case-insensitive but otherwise must be pasted verbatim, including the dashes.
What if I see "code expired" with a code I just generated ?
If the code visibly expires within seconds of being generated, the most likely causes are :
- Clock drift -- your laptop or the Salesforce sandbox you are using has a significant clock skew. Restart your machine and re-sync NTP.
- Cached panel -- you are looking at a stale Aprity Configuration page in the tracker. Hard-refresh the tracker tab (Ctrl + Shift + R or Cmd + Shift + R).
- Disconnected aprity backend -- very rare, transient issue. Wait one minute and re-generate.
If the issue persists, contact support@aprity.ai with your aprity tenant id and the tracker you are trying to connect.
Verify after the fix
After a successful paste, the tracker panel switches to Connected to Aprity (Jira / ADO) or the Slack app reports a successful bind. From there, follow the rest of the per-tracker setup guide to start generating stories.
For anything else, contact support@aprity.ai.