# Artsume: Full Documentation

> Artsume is the professional network for the art world, built on verified credentials. Artists build one verified professional identity (CV, portfolio, statement) that organizations recognize and that opens doors to opportunities. Artists apply to grants, residencies, exhibitions, fellowships, commissions, and more with one click. Organizations create opportunities with custom application forms, review submissions using blind review and scoring rubrics, collaborate with review teams, and manage relationships through a built-in Affiliated Artists workspace. The platform serves two audiences: individual artists (free tier available) and arts organizations (free for all features).

---

## Platform Pages

- [Home](https://www.artsume.com/): Main landing page, overview of the platform for both artists and organizations
- [About](https://www.artsume.com/about): Company background, mission, and team
- [For Organizations](https://www.artsume.com/organizations): Organization-facing landing page with pricing CTA
- [Explore Opportunities](https://www.artsume.com/explore): Searchable directory of open opportunities across all types, with an interactive map
- [Compare](https://www.artsume.com/compare): Feature comparison with alternative platforms

---

## Artist Features

Artists can sign up for free and access core tools for managing their professional presence.

### [Portfolio](https://www.artsume.com/artist-portfolio)
Online portfolio with image galleries, artwork details (medium, dimensions, year), and customizable layout. Each work can be linked to CV entries for a connected professional narrative.

### [CV Builder](https://www.artsume.com/artist-cv-builder)
Structured artist CV with standard sections: solo exhibitions, group exhibitions, publications, awards, grants, residencies, education, collections, commissions, bibliography, and lectures/talks. Entries include year, title, venue, and location. Export-ready formatting.

### [Resume Builder](https://www.artsume.com/artist-resume)
CAA-formatted artist resume builder. Generates a professional, exportable resume from the artist's profile and CV data.

### [Opportunity Tracker](https://www.artsume.com/artist-opportunity-tracker)
Dashboard showing all submitted applications with real-time status updates. Statuses visible to artists: draft, submitted, under review, action required (when more info is requested), decision pending, accepted, rejected, withdrawn.

### [Artist Card](https://www.artsume.com/artist-card)
Shareable digital business card for artists, with an optional Apple/Google Wallet pass. The public profile page at `/a/[handle]` carries the artist statement, bio, portfolio, CV, and contact information.

---

## Organization Features

Organizations subscribe to manage open calls and review applications.

### [Opportunity Management](https://www.artsume.com/organizations/features/opportunity-management)
Create and publish opportunities with descriptions, deadlines (hard, soft, rolling, or until filled), geographic scope, career stage targeting, and fee settings. Supports draft, open, closed, and archived statuses.

### [Custom Application Forms](https://www.artsume.com/organizations/features/custom-forms)
Drag-and-drop form builder for application forms. Field types include text, textarea, select, multi-select, file upload, URL, and more. Conditional logic for showing/hiding fields.

### [Application Review](https://www.artsume.com/organizations/features/application-review)
Review dashboard with application list, detail view, and batch actions. Internal statuses: draft, submitted, under_review, shortlisted, needs_more_info, accepted, rejected, withdrawn. Organizations control when decisions are released to applicants.

### [Blind Review](https://www.artsume.com/organizations/features/blind-review)
Anonymous review mode that hides identifying information (name, profile, etc.) from reviewers. Configurable: choose which fields to anonymize. Each application gets a unique anonymous ID.

### [Scoring Rubrics](https://www.artsume.com/organizations/features/scoring-rubrics)
Create custom scoring criteria with weighted rubric dimensions. Supports multiple scoring modes: rubric-based scoring, qualitative flags (e.g., "Recommend", "Maybe", "Pass"), or a combination. Configurable reviewers-per-application and assignment strategies.

### [Team Collaboration](https://www.artsume.com/organizations/features/team-collaboration)
Invite team members with role-based access (admin, member). Assign reviewers to applications, set lead reviewers, configure review visibility (reviewers can see or not see each other's scores). Review assignment strategies: manual, round-robin, or load-balanced.

### [Analytics](https://www.artsume.com/organizations/features/analytics)
Dashboard with metrics: application volume, review progress, score distributions, time-to-decision, and applicant demographics. Track opportunity performance over time.

### [Affiliated Artists / Contact Management]
Built-in Affiliated Artists workspace for managing relationships with applicants, awardees, and prospective contacts. Contact records are created from applications and CV mentions. Features: custom tags, notes, email history, activity timeline, smart lists with filters, and email campaigns. Segment contacts by application status, opportunity, tags, or custom criteria.

### [Embeddable Widgets]
Embed opportunity listings and application forms on external websites. Available at `/embed/profile/[handle]` and `/embed/work/[id]`. Organizations can embed their open calls on their own site.

### [Pricing](https://www.artsume.com/organizations/pricing)
Subscription plans for organizations. Tiered pricing based on features and opportunity volume.

---

## Opportunity Types

Artsume supports 14 opportunity types, each with a dedicated marketing page:

| Type | Page | Description |
|------|------|-------------|
| Grant | [/organizations/grants](https://www.artsume.com/organizations/grants) | Funding for artistic projects, research, or professional development |
| Residency | [/organizations/residencies](https://www.artsume.com/organizations/residencies) | Time-and-space programs for artists to create work |
| Exhibition | (no dedicated page) | Solo or group exhibition opportunities |
| Fellowship | (no dedicated page) | Extended support programs combining funding, mentorship, and resources |
| Commission | (no dedicated page) | Commissioned artwork for specific projects or sites |
| Prize/Award | [/organizations/awards](https://www.artsume.com/organizations/awards) | Juried competitions and recognition programs |
| Open Call | (no dedicated page) | General calls for submissions (most common type) |
| Public Art | [/organizations/public-art](https://www.artsume.com/organizations/public-art) | Public art commissions and installations |
| Festival/Fair | [/organizations/festivals](https://www.artsume.com/organizations/festivals) | Art fairs, biennials, and festival participation |
| Workshop/Program | [/organizations/workshops](https://www.artsume.com/organizations/workshops) | Educational workshops, masterclasses, and programs |
| Job | [/organizations/jobs](https://www.artsume.com/organizations/jobs) | Employment in the arts (curator, installer, etc.) |
| Internship | (no dedicated page) | Internship positions at arts organizations |
| Gallery | [/organizations/galleries](https://www.artsume.com/organizations/galleries) | Gallery representation and exhibition opportunities |
| General Submission | (no dedicated page) | Catch-all for submissions that don't fit other categories |

---

## Application Workflow

1. **Artist discovers** an opportunity via search, explore, or direct link
2. **Artist applies** by filling out the custom application form and submitting
3. **Organization reviews** using their configured workflow (blind review, rubric scoring, qualitative flags)
4. **Organization decides**: marks applications as accepted, rejected, or shortlisted
5. **Decision released**: organization controls when applicants see the outcome
6. **Affiliated Artists updated**: contact records and activity timelines are automatically maintained

### Application Statuses (Internal → External)
- draft → draft
- submitted → submitted
- under_review → under review
- shortlisted → under review (not revealed to applicant)
- needs_more_info → action required
- accepted → decision pending (until released) → accepted
- rejected → decision pending (until released) → rejected
- withdrawn → withdrawn

---

## Resources

### [Guides](https://www.artsume.com/guides)
In-depth guides for artists on topics like writing artist statements, applying for grants, pricing artwork, and building a professional practice. Available as markdown via `/api/md/guides/[slug]`.

### [Learn](https://www.artsume.com/learn)
Educational articles about the art world: understanding the gallery system, navigating residencies, art career development. Available as markdown via `/api/md/learn/[slug]`.

### [Changelog](https://www.artsume.com/changelog)
Product updates, new features, and improvements. Available as markdown via `/api/md/changelog/[slug]`.

### [Community](https://www.artsume.com/community)
Community resources, events, and shared knowledge. Available as markdown via `/api/md/community/[slug]`.

---

## API

### REST API (v1)

Authentication: API key via `Authorization: Bearer <api_key>` header. Scoped to the organization that owns the key.

#### Opportunities
- `GET /api/v1/opportunities`: List opportunities for the authenticated organization
  - Scope: `read:opportunities`
  - Query params: `status`, `type`, `limit` (max 100), `offset`
- `GET /api/v1/opportunities/[id]`: Get opportunity details
  - Scope: `read:opportunities`
- `POST /api/v1/opportunities`: Create a new opportunity
  - Scope: `write:opportunities`
  - Body: `{ title, description?, type?, status?, deadline?, visibility? }`

#### Applications
- `GET /api/v1/applications`: List applications for the organization's opportunities
  - Scope: `read:applications`
  - Query params: `opportunity_id`, `status` (`submitted` | `withdrawn`; other values ignored), `limit` (max 100), `offset`
- `GET /api/v1/applications/[id]`: Get application details
  - Scope: `read:applications`
- `PATCH /api/v1/applications/[id]`: Update an application's write-state, outcome, score, or reviewer notes
  - Scope: `write:applications`
  - Body (all fields optional): `{ status?, decision?, release?, score?, reviewer_notes? }`
    - `status`: the write-state — one of `draft`, `submitted`, `withdrawn`. The retired process/outcome values (`under_review`, `needs_more_info`, `accepted`, `rejected`) are no longer accepted and return a validation error.
    - `decision`: the deliberate outcome — one of `accepted`, `waitlisted`, `rejected`, `disqualified`. Writes the authoritative outcome fact (separate from `status`). Setting a decision does NOT change `status`.
    - `release`: `true` to make the decision visible to the applicant (stamps the release marker). Requires `decision` in the same request.
  - Response: the same three-field shape as GET (`status`, `decision`, `external_status`).

**Application response shape (BREAKING CHANGE):** the application object now separates write-state, outcome, and the applicant-facing label into three distinct fields:
- `status`: the write-state — one of `draft`, `submitted`, `withdrawn`. (Previously this field carried process/outcome values such as `under_review`, `needs_more_info`, `accepted`, `rejected`; those now collapse to `submitted`.)
- `decision`: the deliberate outcome — one of `accepted`, `waitlisted`, `rejected`, `disqualified`, or `null` when no decision has been recorded. This is the authoritative outcome fact.
- `external_status`: the derived applicant-facing label — one of `draft`, `submitted`, `under_review`, `action_required`, `decision_pending`, `accepted`, `waitlisted`, `rejected`, `withdrawn`. Outcome values only appear here after the organization releases the decision; before release a queued decision surfaces as `decision_pending`.

### LLM-Friendly Markdown Endpoints

These endpoints return content as plain markdown, optimized for LLM consumption:

- `GET /api/md/guides/[slug]`: Guide content
- `GET /api/md/learn/[slug]`: Learn article content
- `GET /api/md/changelog/[slug]`: Changelog entry
- `GET /api/md/community/[slug]`: Community post
- `GET /api/md/opportunities/[id]`: Opportunity details (title, description, requirements, deadline, fees, organization)
- `GET /api/md/a/[handle]`: Artist profile (bio, statement, portfolio, CV)
- `GET /api/md/o/[slug]`: Organization profile (description, open opportunities)

### Public Data Endpoints
- `GET /api/artist/by-handle/[handle]`: Artist profile JSON
- `GET /api/organization/by-slug/[slug]`: Organization profile JSON
- `GET /api/opportunities`: Public opportunity listings

---

## Dynamic Routes

- `/a/[handle]`: Artist profile page (e.g., `/a/jane-doe`)
- `/o/[slug]`: Organization profile page (e.g., `/o/moma`)
- `/opportunities/[id]`: Opportunity detail page
- `/apply/[id]`: Application form for an opportunity
- `/wallet/[handle]`: Digital business card
- `/embed/profile/[handle]`: Embeddable artist profile widget
- `/embed/work/[id]`: Embeddable artwork widget
- `/guides/[slug]`: Individual guide page
- `/learn/[slug]`: Individual learn article page
- `/changelog/[slug]`: Individual changelog entry

---

## Legal & Contact

- [Terms of Service](https://www.artsume.com/terms)
- [Privacy Policy](https://www.artsume.com/privacy)
- [Contact](https://www.artsume.com/contact)
- [Contact Sales](https://www.artsume.com/api/contact-sales): POST endpoint for sales inquiries

---

## Authentication

- [Login](https://www.artsume.com/login): Sign in with email/password
- [Sign Up](https://www.artsume.com/signup): Create a new account (artist or organization)
- [Forgot Password](https://www.artsume.com/forgot-password): Password reset flow

---

## Additional

- [Sitemap](https://www.artsume.com/sitemap.xml): Full XML sitemap
- [llms.txt](https://www.artsume.com/llms.txt): Concise version of this document