What authentication does the Pickaxe API use?

Pickaxe uses Bearer token authentication. The token is included in the Authorization header for all API requests. Through Jentic, Bearer tokens are stored in your Jentic One instance and injected into requests automatically.

Can I create a chatbot with a custom knowledge base?

Yes. First create the Pickaxe chatbot via POST /studio/pickaxe/create with your prompt instructions, then upload documents to it using POST /studio/pickaxe/{pickaxeId}/documents. The chatbot will reference these documents when answering user questions, providing responses grounded in your specific content.

How do I retrieve conversation logs from a deployed chatbot?

Use GET /studio/pickaxe/history to retrieve conversation logs across your chatbots. The endpoint returns full conversation threads including user messages and bot responses, which you can filter and analyze for quality monitoring or prompt improvement.

How do I deploy a new chatbot through Jentic?

Search Jentic for 'create an AI chatbot application' to find the POST /studio/pickaxe/create operation. Load the schema to see configuration options (prompt, personality, response settings), then execute with your desired chatbot parameters. Jentic handles bearer token authentication for the Pickaxe platform.

Can I limit what my agent is allowed to do with the Pickaxe API?

Yes. Because you run Jentic One yourself, your own rules decide which Pickaxe operations and credentials the agent may use. Since Pickaxe puts the pickaxe id in the URL path (/studio/pickaxe/{pickaxeId}), you can pin the agent to a single bot so it only reads that pickaxe's configuration and adds documents to its knowledge base. Creating new pickaxes or overwriting a bot's configuration stays off-limits unless you explicitly grant those operations.