Working with Page Data

AI agents can read and manipulate data stored in Visimade pages, enabling powerful automation and intelligent data processing workflows.

Data operations require the appropriate API token scopes: team-data:read, team-data:write, solo-data:read, solo-data:write, social-data:read, or social-data:write depending on the page's storage mode.

Understanding Storage Modes

Before working with data, you need to know the page's storage mode:

Mode	API Endpoint	Use Case
`team_app`	`/api/pages/:id/team-data/:collection`	Shared data for team collaboration (kanban boards, project trackers)
`solo_app`	`/api/pages/:id/solo-data/:collection`	Private data for each user (personal notes, settings)
`social_app`	`/api/pages/:id/social-data/:collection`	Public data with ownership (comments, reviews, submissions)

Example: Analyze Page Data

Ask the AI to read and analyze data from a page:

My Visimade API token is: vm_your_token_here

See the Visimade documentation at: https://visimade.com/ai-agents/visimade-md

I have a team kanban board at /p/sprint-board

Can you:
1. List all the collections in this page
2. Show me all tasks in the "backlog" status
3. Summarize the distribution of tasks across statuses
4. Identify any tasks that have been in "in_progress" for more than a week

Example: Intelligent Task Assignment

Have the AI pick up tasks and work on them:

My Visimade API token is: vm_your_token_here

See the Visimade documentation at: https://visimade.com/ai-agents/visimade-md

Look at the tasks in /p/project-board-kanban

Find a task in the "backlog" column that involves writing documentation.
Tell me what you would do to complete it, then:
1. Move it to "in_progress"
2. Add a comment explaining your approach
3. When done, move it to "review" and update the description with what was completed

Example: Bulk Data Operations

AI agents can efficiently process large amounts of data:

My Visimade API token is: vm_your_token_here

See the Visimade documentation at: https://visimade.com/ai-agents/visimade-md

I have a feedback collection at /p/customer-feedback with hundreds of entries.

Please:
1. Read all the feedback entries
2. Categorize each one as: bug_report, feature_request, praise, or complaint
3. Update each record with the category
4. Create a summary report showing counts for each category
5. List the top 5 most requested features

Example: Data Import/Migration

Import data from external sources:

My Visimade API token is: vm_your_token_here

See the Visimade documentation at: https://visimade.com/ai-agents/visimade-md

I have a new inventory tracking page at /p/inventory-tracker

Please import this product data into the "products" collection:

Product 1: Widget A, SKU: WA-001, Price: $29.99, Stock: 150
Product 2: Gadget B, SKU: GB-002, Price: $49.99, Stock: 75
Product 3: Tool C, SKU: TC-003, Price: $19.99, Stock: 200

Structure each record with fields: name, sku, price, stock, createdAt

Example: Generate Reports

My Visimade API token is: vm_your_token_here

See the Visimade documentation at: https://visimade.com/ai-agents/visimade-md

I have a time tracking page at /p/team-time-tracker

Generate a weekly report that includes:
1. Total hours logged by each team member
2. Hours breakdown by project
3. Average daily hours
4. Any days with no logged time (potential missing entries)
5. Comparison to last week's totals

Example: Data Cleanup

My Visimade API token is: vm_your_token_here

See the Visimade documentation at: https://visimade.com/ai-agents/visimade-md

The "contacts" collection at /p/contact-manager has some messy data.

Please:
1. Find and merge duplicate contacts (same email or phone)
2. Standardize phone number formats to (XXX) XXX-XXXX
3. Capitalize names properly
4. Remove any records with no email AND no phone
5. Show me what changes you're making before applying them

Data Safety Tips

Ask for confirmation before deleting: Tell the AI to show you what it plans to delete and wait for your approval.
Start with read operations: Have the AI analyze and report before making any changes.
Use test data first: If trying a new workflow, test on a copy of your data or a small subset.
Check the total count: Verify the number of records affected matches your expectations.
Keep your token secure: Don't share conversations that contain your API token.

Advanced: Chaining Operations

AI agents excel at multi-step workflows that combine reading, analyzing, and updating data:

My Visimade API token is: vm_your_token_here

See the Visimade documentation at: https://visimade.com/ai-agents/visimade-md

I have an e-commerce dashboard at /p/sales-dashboard

Every day at the end of business, I need you to:

1. Read all orders from the "orders" collection created today
2. Calculate total revenue and order count
3. Identify the best-selling products
4. Check inventory levels - flag any products below 10 units
5. Create a new record in the "daily_reports" collection with this data
6. If any products are low stock, add them to the "reorder_alerts" collection

Run this analysis now for today's data.

Next: VISIMADE.md Reference →← Back: Editing a Page View Full API Documentation